头图

今日分享开始啦,请大家多多指教~

外部服务对于调用者来说一般都是不可靠的,尤其是在网络环境比较差的情况下,网络抖动很容易导致请求超时等异常情况,这时候就需要使用失败重试策略重新调用 API 接口来获取。重试策略在服务治理方面也有很广泛的使用,通过定时检测,来查看服务是否存活。

Spring 异常重试框架 Spring Retry

Spring Retry 支持集成到 Spring 或者 Spring Boot 项目中,而它支持 AOP 的切面注入写法,所以在引入时必须引入 aspectjweaver.jar 包。

1.引入 maven 依赖

2.添加 @Retryable 和 @Recover 注解

@Retryable 注解,被注解的方法发生异常时会重试

  • value:指定发生的异常进行重试
  • include:和 value 一样,默认空,当 exclude 也为空时,所有异常都重试
  • exclude:指定异常不重试,默认空,当 include 也为空时,所有异常都重试
  • maxAttemps:重试次数,默认 3
  • backoff:重试补偿机制,默认没有

@Backoff 注解

  • delay:指定延迟后重试
  • multiplier:指定延迟的倍数,比如 delay=5000l,multiplier=2 时,第一次重试为 5 秒后,第二次为 10 秒,第三次为 20 秒

@Recover 注解:当重试到达指定次数时,被注解的方法将被回调,可以在该方法中进行日志处理。需要注意的是发生的异常和入参类型一致时才会回调。

image

3.启用重试功能

启动类上面添加 @EnableRetry 注解,启用重试功能,或者在使用 retry 的 service 上面添加也可以,或者 Configuration 配置类上面。建议所有的 Enable 配置加在启动类上,可以清晰地统一管理使用的功能。

4.启动服务,运行测试

image

基于 guava 的重试组件 Guava-Retryer

直接看组件作者对此组件的介绍:

This is a small extension to Google’s Guava library to allow for the creation of configurable retrying strategies for an arbitrary function call, such as something that talks to a remote service with flaky uptime.(这是对 Google 的 guava 库的一个小扩展,允许为任意函数调用创建可配置的重试策略,例如与运行时间不稳定的远程服务对话的策略。)

第一步引入 maven 坐标:

1.其主要接口及策略介绍

  • Attempt:一次执行任务;
  • AttemptTimeLimiter:单次任务执行时间限制(如果单次任务执行超时,则终止执行当前任务);
  • BlockStrategies:任务阻塞策略(通俗的讲就是当前任务执行完,下次任务还没开始这段时间做什么……- - BlockStrategies.THREAD_SLEEP_STRATEGY 也就是调用 Thread.sleep(sleepTime);
  • RetryException:重试异常;
  • RetryListener:自定义重试监听器,可以用于异步记录错误日志;
  • StopStrategy:停止重试策略,提供三种:
  • StopAfterDelayStrategy:设定一个最长允许的执行时间;比如设定最长执行 10s,无论任务执行次数,只要重试的时候超出了最长时间,则任务终止,并返回重试异常 RetryException;
  • NeverStopStrategy:不停止,用于需要一直轮训直到返回期望结果的情况;
  • StopAfterAttemptStrategy:设定最大重试次数,如果超出最大重试次数则停止重试,并返回重试异常;
  • WaitStrategy:等待时长策略(控制时间间隔),返回结果为下次执行时长:
  • FixedWaitStrategy:固定等待时长策略;
  • RandomWaitStrategy:随机等待时长策略(可以提供一个最小和最大时长,等待时长为其区间随机值)
  • IncrementingWaitStrategy:递增等待时长策略(提供一个初始值和步长,等待时间随重试次数增加而增加)
  • ExponentialWaitStrategy:指数等待时长策略;
  • FibonacciWaitStrategy :Fibonacci 等待时长策略;
  • ExceptionWaitStrategy :异常时长等待策略;
  • CompositeWaitStrategy :复合时长等待策略;

2.根据结果判断是否重试

使用场景:如果返回值决定是否要重试。重试接口:

测试:

输出:

3.根据异常判断是否重试

使用场景:根据抛出异常类型判断是否执行重试。重试接口:

测试:

输出:

4.重试策略——设定无限重试

使用场景:在有异常情况下,无限重试(默认执行策略),直到返回正常有效结果;

5.重试策略——设定最大的重试次数

使用场景:在有异常情况下,最多重试次数,如果超过次数则会抛出异常;

测试:

输出:

6.等待策略——设定重试等待固定时长策略

使用场景:设定每次重试等待间隔固定为 10s;

测试输出,可以看出调用间隔是 10S:

7.等待策略——设定重试等待时长固定增长策略

场景:设定初始等待时长值,并设定固定增长步长,但不设定最大等待时长;

测试输出,可以看出调用间隔时间递增 1 秒:

8.等待策略——设定重试等待时长按指数增长策略

使用场景:根据 multiplier 值按照指数级增长等待时长,并设定最大等待时长;

这个重试策略和入参不是很懂,好吧,查看源码:

通过源码看出 ExponentialWaitStrategy 是一个不可变的内部类,构造器中校验入参,最重要的延迟时间计算方法 computeSleepTime(),可以看出延迟时间计算方式

计算以 2 为底失败次数为指数的值

第一步的值构造器第一个入参相乘,然后四舍五入得到延迟时间(毫秒)

通过以上分析可知入参为 1000 时间隔是应该为 2,4,8s

测试输出,可以看出调用间隔时间 2×1000,4×1000,8×1000:

9.等待策略——设定重试等待时长按斐波那契数列策略

使用场景:根据 multiplier 值按照斐波那契数列增长等待时长,并设定最大等待时长,斐波那契数列:1、1、2、3、5、8、13、21、34、……

同样,看源码可知计算可知延迟时间为斐波那契数列和第一入参的乘积(毫秒)

测试输出,可看出间隔调用为 1×1000,1×1000,2×1000:

10.等待策略——组合重试等待时长策略

使用场景:当现有策略不满足使用场景时,可以对多个策略进行组合使用。

同样,看源码才能理解组合策略是什么意思:

可看出组合策略其实按照多个策略的延迟时间相加得到组合策略的延迟时间。exponentialWait 的延迟时间为 2,4,8,16,32…,fixedWait 延迟为 2,2,2,2,2…,所以总的延迟时间为 4,6,10,18,34…

测试输出:

11.监听器——RetryListener 实现重试过程细节处理

使用场景:自定义监听器,分别打印重试过程中的细节,未来可更多的用于异步日志记录,亦或是特殊处理。

测试:

输出:

总结

两种方式都是比较优雅的重试策略,Spring-retry 配置更简单,实现的功能也相对简单,Guava 本身就是谷歌推出的精品 java 类库,guava-retry 也是功能非常强大,相比较于 Spring-Retry 在是否重试的判断条件上有更多的选择性,可以作为 Spring-retry 的补充。


Java架构师
179 声望65 粉丝