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、……




