外部服务对于调用者来说一般都是不可靠的,尤其是在网络环境比较差的情况下,网络抖动很容易导致请求超时等异常情况,这时候就需要使用失败重试策略重新调用 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注解: 当重试到达指定次数时,被注解的方法将被回调,可以在该方法中进行日志处理。需要注意的是发生的异常和入参类型一致时才会回调。
3、启用重试功能
启动类上面添加@EnableRetry注解,启用重试功能,或者在使用retry的service上面添加也可以,或者Configuration配置类上面。
建议所有的Enable配置加在启动类上,可以清晰地统一管理使用的功能。
4、启动服务,运行测试
基于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的补充。
网友评论