基础设置参数

快速开始

基础设置参数是重试组件最核心的配置，包含场景标识、重试次数和重试间隔等基本参数。

1. 参数说明

参数	描述	默认值	必填
scene	重试场景标识	无	✅
localTimes	本地重试次数（必须≥1）	3	✅
localInterval	本地重试间隔（秒）	2	✅

2. 使用示例

@Retryable(
    scene = "order-payment",    // 场景标识
    localTimes = 3,            // 本地重试3次
    localInterval = 2          // 间隔2秒
)
public boolean processPayment(OrderVo orderVo) {
    // 支付处理逻辑
}

3. 参数详解

3.1 场景标识（scene）

• 用于区分不同的重试场景
• 建议使用有业务含义的名称
• 同一场景使用相同标识

3.2 重试次数（localTimes）

• 本地重试的最大次数
• 必须大于等于1
• 建议设置为3-5次

3.3 重试间隔（localInterval）

• 两次重试之间的等待时间
• 单位为秒
• 建议根据业务特点设置

4.Demo演示

本地重试的时间间隔。这个是在任务完成之后间隔的时长。单位：秒。注意示例中的时间间隔：

@Retryable(scene = SceneConstant.LOCAL_RETRY, 
       retryStrategy = RetryType.ONLY_LOCAL, 
       localTimes = 2, localInterval = 3)
public void localRetry(String params) {
    System.out.println("local retry 方法开始执行");
    ThreadUtil.sleep(4000);
    throw new RuntimeException("local retry 方法执行异常");
}

5. 使用建议

• 根据业务场景合理设置参数
• 避免过多的重试次数
• 合理控制重试间隔
• 使用有意义的场景标识