更好的 java 重试框架 sisyphus 配置的 2 种方式介绍开源github分布式

回顾我们前面学习了
【更好的 java 重试框架 sisyphus 配置的 2 种方式介绍】更好的 java 重试框架 sisyphus 入门简介
更好的 java 重试框架 sisyphus 背后的故事
这一节让我们一起学习下 sisyphus 基于函数式的配置和注解式的配置。
函数式配置概览为了满足更加方便的配置，Retryer 类提供了许多可以配置的信息。
默认配置

/** * 默认配置测试 */ public void defaultConfigTest() { Retryer.newInstance() .condition(RetryConditions.hasExceptionCause()) .retryWaitContext(RetryWaiter.retryWait(NoRetryWait.class).context()) .maxAttempt(3) .listen(RetryListens.noListen()) .recover(Recovers.noRecover()) .callable(new Callable() { @Override public String call() throws Exception { System.out.println("called..."); throw new RuntimeException(); } }).retryCall(); }

和下面的代码是等价的：

public void helloTest() { Retryer.newInstance() .callable(new Callable() { @Override public String call() throws Exception { System.out.println("called..."); throw new RuntimeException(); } }).retryCall(); }

方法说明 condition 重试触发的条件，可以指定多个条件。
默认为抛出异常。
retryWaitContext 重试等待的策略，可以指定多个。
默认为不做任何等待。
maxAttempt 指定最大重试次数，包括第一次执行。
默认值：3 次。
listen 指定重试的监听实现，默认为不做监听。
recover 当重试完成之后，依然满足重试条件，则可以指定恢复的策略。
默认不做恢复。
callable 待重试执行的方法。
retryCall 触发重试执行。
接口的详细介绍接口及其实现所有的接口，都可以直接查看对应的子类实例。
用户自定义基于替换的灵活性，用户可以实现接口，定义更符合自己业务的实现。
sisyphus 注解配置具有很高的灵活性，但是对于开发人员的使用，就没有注解那样简单灵活。
所以本框架也实现了基于注解的重试。
设计的规范保证接口和注解二者的统一性。
maven 引入

${project.groupId} sisyphus-annotation ${project.version}

注解核心注解主要有两个。
Retry 用于指定重试的相关配置。

/** * 重试注解 * 1. 实际需要，只允许放在方法上。 * 2. 如果放在接口上，是否所有的子类都生效？为了简单明确，不提供这种实现。 * 3. 保持注解和接口的一致性。{@link com.github.houbb.sisyphus.api.core.Retry} 接口 * @author binbin.hou * @since 0.0.3 */ @Documented @Inherited @Target(ElementType.METHOD) @Retention(RetentionPolicy.RUNTIME) @RetryAble(DefaultRetryAbleHandler.class) public @interface Retry {/** * 重试类实现 * @return 重试 * @since 0.0.5 */ Class retry() default DefaultRetry.class; /** * 最大尝试次数 * 1. 包含方法第一次正常执行的次数 * @return 次数 */ int maxAttempt() default 3; /** * 重试触发的场景 * @return 重试触发的场景 */ Class condition() default ExceptionCauseRetryCondition.class; /** * 监听器 * 1. 默认不进行监听 * @return 监听器 */ Class listen() default NoRetryListen.class; /** * 恢复操作 * 1. 默认不进行任何恢复操作 * @return 恢复操作对应的类 */ Class recover() default NoRecover.class; /** * 等待策略 * 1. 支持指定多个，如果不指定，则不进行任何等待， * @return 等待策略 */ RetryWait[] waits() default {}; }

RetryWait 用于指定重试的等待策略。

package com.github.houbb.sisyphus.annotation.annotation; import com.github.houbb.sisyphus.annotation.annotation.metadata.RetryWaitAble; import com.github.houbb.sisyphus.annotation.handler.impl.DefaultRetryWaitAbleHandler; import com.github.houbb.sisyphus.core.constant.RetryWaitConst; import com.github.houbb.sisyphus.core.support.wait.NoRetryWait; import java.lang.annotation.*; /** * 重试等待策略 * 1. 为了对应重试策略，所有的内置注解应该实现当前的注解。 * 2. 是否允许自定义注解？ * * 当注解+对象同时出现的时候，视为组合。 * * @author binbin.hou * @since 0.0.3 */ @Retention(RetentionPolicy.RUNTIME) @Inherited @Documented @Target(ElementType.ANNOTATION_TYPE) @RetryWaitAble(DefaultRetryWaitAbleHandler.class) public @interface RetryWait {/** * 默认值 * 1. fixed 模式，则对应固定等待时间 * 2. 递增 * @return 默认值 */ long value() default RetryWaitConst.VALUE_MILLS; /** * 最小值 * @return 最小值 */ long min() default RetryWaitConst.MIN_MILLS; /** * 最大值 * @return 最大值 */ long max() default RetryWaitConst.MAX_MILLS; /** * 影响因数 * 1. 递增重试，默认为 {@link RetryWaitConst#INCREASE_MILLS_FACTOR} * 2. 指数模式。默认为 {@link RetryWaitConst#MULTIPLY_FACTOR} * @return 影响因数 */ double factor() default Double.MIN_VALUE; /** * 指定重试的等待时间 class 信息 * @return 重试等待时间 class */ Class retryWait() default NoRetryWait.class; }

注解的使用定义好了注解，肯定要有注解的相关使用。
关于注解的使用，主要有两种方式。
Proxy+CGLIB 基于代理模式和字节码增强。
如果是项目中没有使用 spring，直接使用这种方式比较方便。
Spring-AOP 可以和 spring 直接整合。
使用方式和 spring-retry 是一样的。
这些内容将放在下一节进行详细讲解。
小结灵活的配置才能更加符合实际生产使用中的各种需求。
一般实际使用推荐使用注解的配置方式，非常的简单方便。