微信公众号:deepstack 欢迎一起交流
背景:在业务中,出现方法执行失败需要重试的场景很多,如网络抖动导致的连接失败或者超市等。
优雅实现:
1、减少代码侵入
2、方便可用
3、配置灵活
步骤:
1、创建一个annotation。源码如下。
1 /**
2 * <用来异常重试>
3 * 注意:needThrowExceptions & catchExceptions 是相关联的, 有顺序依赖。
4 * 当这两个数组的长度都为0时, 直接执行重试逻辑。
5 *
6 * @author lihaitao on 2019/1/2
7 * @version 1.0
8 * @see ExceptionRetryAspect
9 */
10 @Documented
11 @Target(ElementType.METHOD)
12 @Retention(RetentionPolicy.RUNTIME)
13 public @interface ExceptionRetry {
14 /**
15 * 设置失败之后重试次数,默认为1次。
16 * 少于1次,则默认为1次
17 * 推荐最好不要超过5次, 上限为10次
18 * 当没有重试次数时, 会将异常重新抛出用来定位问题。
19 *
20 * @return
21 */
22 int times() default 1;
23
24 /**
25 * 重试等待时间,时间单位为毫秒。默认是 0.5 * 1000ms, 小于等于0则不生效
26 * 推荐不要超过 3 * 1000ms
27 * 上限为 10 * 1000ms
28 *
29 * @return
30 */
31 long waitTime() default 500;
32
33 /**
34 * 需要抛出的异常, 这些异常发生时, 将直接报错, 不再重试。
35 * 传入一些异常的class对象
36 * 如UserException.class
37 * 当数组长度为0时, 那么都不会抛出, 会继续重试
38 *
39 * @return 异常数组
40 */
41 Class[] needThrowExceptions() default {};
42
43 /**
44 * 需要捕获的异常, 如果需要捕获则捕获重试。否则抛出异常
45 * 执行顺序 needThrowExceptions --> catchExceptions 两者并不兼容
46 * 当 needThrowExceptions 判断需要抛出异常时, 抛出异常, 否则进入此方法, 异常不在此数组内则抛出异常
47 * 当数组长度为0时, 不会执行捕获异常的逻辑。
48 *
49 * @return 异常数组
50 */
51 Class[] catchExceptions() default {};
52 }
53
2、有了注解之后,我们还需要对这个注解的方法进行处理。所以我们还要写一个切面。
/**
* <异常重试切面>
*
* @author lihaitao on 2019/1/2
*/
@Aspect
@Component
public class ExceptionRetryAspect {
private static final Logger LOGGER = LoggerFactory.getLogger(ExceptionRetryAspect.class);
@Pointcut("@annotation(com.jason.annotation.ExceptionRetry)")
public void retryPointCut() {
}
@Around("retryPointCut()")
public Object around(ProceedingJoinPoint joinPoint) throws Throwable {
MethodSignature methodSignature = (MethodSignature) joinPoint.getSignature();
Method method = methodSignature.getMethod();
ExceptionRetry retry = method.getAnnotation(ExceptionRetry.class);
String name = method.getName();
Object[] args = joinPoint.getArgs();
String uuid = UUID.randomUUID().toString();
LOGGER.info("执行重试切面{}, 方法名称{}, 方法参数{}", uuid, name, JsonUtil.toJson(args));
int times = retry.times();
long waitTime = retry.waitTime();
Class[] needThrowExceptions = retry.needThrowExceptions();
Class[] catchExceptions = retry.catchExceptions();
// check param
if (times <= 0) {
times = 1;
}
for (; times >= 0; times--) {
try {
return joinPoint.proceed();
} catch (Exception e) {
// 如果需要抛出的异常不是空的, 看看是否需要抛出
if (needThrowExceptions.length > 0) {
for (Class exception : needThrowExceptions) {
if (exception == e.getClass()) {
LOGGER.warn("执行重试切面{}失败, 异常在需要抛出的范围{}, 业务抛出的异常类型{}", uuid, needThrowExceptions, e.getClass().getName());
throw e;
}
}
}
// 如果需要抛出异常,而且需要捕获的异常为空那就需要再抛出
if (catchExceptions.length > 0) {
boolean needCatch = false;
for (Class catchException : catchExceptions) {
if (e.getClass() == catchException) {
needCatch = true;
break;
}
}
if (!needCatch) {
LOGGER.warn("执行重试切面{}失败, 异常不在需要捕获的范围内, 需要捕获的异常{}, 业务抛出的异常类型{}", uuid, catchExceptions, e.getClass().getName());
throw e;
}
}
// 如果接下来没有重试机会的话,直接报错
if (times <= 0) {
LOGGER.warn("执行重试切面{}失败", uuid);
throw e;
}
// 休眠 等待下次执行
if (waitTime > 0) {
Thread.sleep(waitTime);
}
LOGGER.warn("执行重试切面{}, 还有{}次重试机会, 异常类型{}, 异常信息{}, 栈信息{}", uuid, times, e.getClass().getName(), e.getMessage(), e.getStackTrace());
}
}
return false;
}
3、写完了切面,我们再继续处理测试逻辑,看看写的好使不好使,此处的代码是模拟redis链接异常。我们先在redis conn 正常的情况下触发此测试方法,在执行过程中,是否能重试?拭目以待
1 /**
2 * <TestController>
3 * <详细介绍>
4 *
5 * @author lihaitao on 2019/1/2
6 */
7 @RestController
8 @RequestMapping("/test")
9 public class TestController {
10
11 @Autowired
12 private IRedisService iRedisService;
13
14 @GetMapping("/exception-retry-aop")
15 @ExceptionRetry(needThrowExceptions = {NullPointerException.class}, times = 5,
16 catchExceptions = {QueryTimeoutException.class, RedisConnectionFailureException.class}, waitTime = 2 * 1000)
17 public void test() {
18 for (int i = 1; i < 100; i++) {
19 iRedisService.setValue("userName", "jason");
20 try {
21 Thread.sleep(4000L);
22 } catch (InterruptedException e) {
23 e.printStackTrace();
24 }
25 }
26 }
27 }
4、测试结果截图
下面是在连接正常的情况下,直接kill掉redis进程,让方法进行重试,可以看到方法重试了5次,最终因为redis没有启动起来还是执行失败了。
下面放一张redis在尝试次数未耗尽时,如果重新连接上的话,在下次重试的时候就会重新执行方法
总结:
异常处理机制的步骤:catch Exception(捕获什么异常,忽略什么异常) ——》 do Something(怎么做,异步?同步?重试还是只是记录留待之后再执行?需要等待否?监控记录?)。
其他Java Exception Retry实现还有:Guava Retryer、Spring Retry 。实现原理大同小异。
转载请说明出处~