您现在的位置是：亿华云 > 人工智能

更好的 Java 重试框架 Sisyphus 配置的两种方式介绍

亿华云2025-10-03 02:18:43【人工智能】2人已围观

简介这一节让我们一起学习下 sisyphus 基于函数式的配置和注解式的配置。函数式配置概览为了满足更加方便的配置，Retryer 类提供了许多可以配置的信息。默认配置/***默认配置测试*/public

这一节让我们一起学习下 sisyphus 基于函数式的更好配置和注解式的配置。

函数式配置概览

为了满足更加方便的重置配置，Retryer 类提供了许多可以配置的试框信息。

默认配置

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

和下面的架S介绍代码是等价的：

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

方法说明

condition

重试触发的条件，可以指定多个条件。两种

默认为抛出异常。更好

retryWaitContext

重试等待的重置策略，可以指定多个。试框

默认为不做任何等待。架S介绍

maxAttempt

指定最大重试次数，两种包括第一次执行。更好

默认值：3 次。重置

listen

指定重试的试框监听实现，默认为不做监听。架S介绍

recover

当重试完成之后，两种依然满足重试条件，则可以指定恢复的策略。

默认不做恢复。

callable

待重试执行的方法。

retryCall

触发重试执行。

接口的详细介绍

接口及其实现

所有的云服务器提供商接口，都可以直接查看对应的子类实例。

用户自定义

基于替换的灵活性，用户可以实现接口，定义更符合自己业务的实现。

sisyphus 注解

配置具有很高的灵活性，但是对于开发人员的使用，就没有注解那样简单灵活。

所以本框架也实现了基于注解的重试。

设计的规范

保证接口和注解二者的统一性。

maven 引入

<dependency> <groupId>${ project.groupId}</groupId> <artifactId>sisyphus-annotation</artifactId> <version>${ project.version}</version> </dependency>

注解

核心注解主要有两个。

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<? extends com.github.houbb.sisyphus.api.core.Retry> retry() default DefaultRetry.class; /** * 最大尝试次数 * 1. 包含方法第一次正常执行的次数 * @return 次数 */ int maxAttempt() default 3; /** * 重试触发的亿华云计算场景 * @return 重试触发的场景 */ Class<? extends RetryCondition> condition() default ExceptionCauseRetryCondition.class; /** * 监听器 * 1. 默认不进行监听 * @return 监听器 */ Class<? extends RetryListen> listen() default NoRetryListen.class; /** * 恢复操作 * 1. 默认不进行任何恢复操作 * @return 恢复操作对应的类 */ Class<? extends Recover> 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<? extends com.github.houbb.sisyphus.api.support.wait.RetryWait> retryWait() default NoRetryWait.class; }