spring retry是从spring batch独立出来的一个能功能,主要实现了重试和熔断。对于重试是有场景限制的,不是什么场景都适合重试,比如参数校验不合法、写操作等(要考虑写是否幂等)都不适合重试。远程调用超时、网络突然中断可以重试。在微服务治理框架中,通常都有自己的重试与超时配置,比如dubbo可以设置retries=1,timeout=500调用失败只重试1次,超过500ms调用仍未返回则调用失败。在spring retry中可以指定需要重试的异常类型,并设置每次重试的间隔以及如果重试失败是继续重试还是熔断(停止重试)。
设计与实现
RetryOperations
定义重试的API,RetryTemplate
是API的模板模式实现,实现了重试和熔断。提供的API如下:
public interface RetryOperations {
<T, E extends Throwable>T execute(RetryCallback<T, E>retryCallback) throws E;
}
// 其他API已省略
RetryCallback
定义了需要执行重试的操作,定义好操作后,就是如何重试的问题了。RetryTemplate
通过制定不同的重试策略来执行如何重试的逻辑。默认的重试策略是SimpleRetryPlicy
,也就是会重试3次。重试第1次如果成功后面就不会继续重试了。那么如果3尺都重试失败了呢?流程结束或者返回兜底结果。要返回兜底结果需要配置RecoveyCallBack
,从名字可以看出这是一个兜底回调接口,也就是重试失败后执行的逻辑。除了SimpleRetryPolicy
还有其他重试策略,先来看下RetryPolicy
接口:
public interface RetryPolicy extends Serializable {
boolean canRetry(RetryContext context);
RetryContext open(RetryContext parent);
void close(RetryContext context);
void registerThrowable(RetryContext context, Throwable throwable);
}
canRetry
在每次重试的时候调用,是否可以继续重试的判断条件
open
重试开始前调用,会创建一个重试上下文到RetryContext
,保存重试的堆栈等信息
registerThrowable
每次重试异常时调用(有异常会继续重试)
以SimpleRetryPolicy
为例,当重试次数达到3(默认3次)停止重试,重试次数保存在重试上下文中。
提供如下重试策略实现:
- NeverRetryPolicy:只允许调用RetryCallback一次,不允许重试
- AlwaysRetryPolicy:允许无限重试,直到成功,此方式逻辑不当会导致死循环
- SimpleRetryPolicy:固定次数重试策略,默认重试最大次数为3次,RetryTemplate默认使用的策略
- TimeoutRetryPolicy:超时时间重试策略,默认超时时间为1秒,在指定的超时时间内允许重试
- ExceptionClassifierRetryPolicy:设置不同异常的重试策略,类似组合重试策略,区别在于这里只区分不同异常的重试
- CircuitBreakerRetryPolicy:有熔断功能的重试策略,需设置3个参数openTimeout、resetTimeout和delegate
- CompositeR