一、前言
好的代码应该具备健壮性,比如代码里面调用了一个http请求,如果当时网络抖了下,http就调用失败了,这时候我们往往需要重试,本文我们就来介绍一个功能比较完善的重试组件-Retryer。
二、Retryer介绍
使用组件需要首先在项目中引入maven依赖:
<dependency>
<groupId>com.github.rholder</groupId>
<artifactId>guava-retrying</artifactId>
<version>2.0.0</version>
</dependency>
下面我们通过一个例子,来看如何使用该组件:
// 1.创建重试器对象
private final static Retryer<Boolean> retryer = RetryerBuilder.<Boolean>newBuilder()
.retryIfResult(Predicates.<Boolean>isNull())// 1.1当重试的方法返回null时候进行重试
.retryIfExceptionOfType(IOException.class)// 1.2当重试方法抛出IOException类型异常时候进行重试
.withStopStrategy(StopStrategies.stopAfterAttempt(3))// 1.3尝试执行三次(也就是重试2次)
.withWaitStrategy(WaitStrategies.fixedWait(2, TimeUnit.SECONDS))//1.4重试间隔
.build();
public static void main(String[] args) {
// 2需要重试的方法
Callable<Boolean> callable = new Callable<Boolean>() {
public Boolean call() throws Exception {
// dosomthing
return null; // do something useful here
}
};
// 3.添加需要重试方法到执行器
try {
Boolean result = retryer.call(callable);
System.out.println(result);
} catch (RetryException e) {
e.printStackTrace();
} catch (ExecutionException e) {
e.printStackTrace();
}
}
如上代码1我们创建了一个重试器对象并配置了其重试参数,其中代码1.1我们使用retryIfResult方法设置当重试方法返回值什么时候进行重试,这里我们设置当返回值为null时候进行重试,该方法枚举值有:
- alwaysTrue() 无论返回值是啥,都进行重试
- alwaysFalse() 返回值是啥,都不进行重试
- isNull() 返回值为null,进行重试
- notNull() 返回值不为null,进行重试
- not(Predicate<T> predicate) 自己设置谓词表达式,决定返回值为啥时候时候进行重试
代码1.2通过retryIfExceptionOfType方式设置,当重试的方法执行过程中抛出了什么类型的异常后,进行重试。在进行重试时候一般我们不是发生什么错误都进行重试,比如执行数据库插入操作时候,如果发生了主键冲突,则没必要进行重试。
代码1.3设置重试停止策略,一般我们都传递StopStrategies.stopAfterAttempt(3)来设置重试次数,比如我们设置重试方法执行3次(一次正常执行,二次重试),如果还是失败则停止重试。
代码1.4设置重试间隔,通过方法 withWaitStrategy,设置当重试方法执行失败后,下一次重试什么时候开始,一般策略有等待多少时间后,进行下一次重试,常用策略如下:
- WaitStrategies.fixedWait(2, TimeUnit.SECONDS) 等待固定多少时间进行重试
- WaitStrategies.incrementingWait(3, TimeUnit.SECONDS,1,TimeUnit.SECONDS) 每次重试等待时间添加个增量
- WaitStrategies.fibonacciWait(1000,10,TimeUnit.SECONDS) 斐波那契数列方式设置重试间隔。
如上代码2我们创建了一个需要重试的任务,代码3添加需要重试方法到执行器。最后Retryer是线程安全的?也就是整个JVM内我创建了一个retryer实例,多线程同时向retryer里面添加重试任务,会存在问题?
答案是,不存在问题,其是线程安全的。这是因为Retryer内部与重试相关的变量是在第一次添加任务时候,通过new了与任务相关的ResultAttempt进行隔离了,每个重试任务有自己的ResultAttempt变量来记录重试信息。
组件开源地址:https://github.com/rholder/guava-retrying
三、总结
工具用的6,可以提高工作效率;另一方面好的开源组件,代码质量还是比较高的,可以学习期设计思想与代码实现;最后使用开源组件相比自己手写也可以提高稳定性^^。一句话:善用工具,会起到事半功倍的效果。
更多技术分享,请扫描关注微信公众号:
file
网友评论