如何使用Spring提供的Retry

0、本例中使用的是 springboot-2.0.4.RELEASE,jdk1.8

1、导包。需要注意版本。2.0.0需要spring6和jdk17


    org.springframework.retry
    spring-retry
    1.3.4

2、启用Retry

@EnableRetry	// 启用 Spring 重试
@SpringBootApplication
public class DemoSpringApplication {

	public static void main(String[] args) {
		SpringApplication.run(DemoSpringApplication .class, args);
	}

}

3、使用Retry

@Retryable(include = { NullPointerException.class, RuntimeException.class }
, exclude={ Exception.class } 
, maxAttempts = 5
, backoff = @Backoff(delay = 1000L, multiplier = 2))
public String downloadWithRetry(ReportRecord record) {}

4、参数说明:

4.1、value:抛出指定异常才会重试
4.2、include:和value一样,默认为空,当exclude也为空时,默认所有异常
4.3、exclude:指定不处理的异常
4.4、maxAttempts:最大重试次数,默认3次
4.5、backoff:重试等待策略,默认使用@Backoff,@Backoff的value默认为1000L
                multiplier(指定延迟倍数)默认为0,表示固定暂停1秒后进行重试,
                如果把multiplier设置为1.5,则第一次重试为2秒,第二次为3秒,第三次为4.5秒。
4.6、@Backoff注解中的参数说明:
        4.6.1、delay:每次重试延迟毫秒数,默认为0L
        4.6.2、value:delay的别名,默认为1000L,当delay>0时,value将会被忽略
        4.6.3、maxDelay:最大延迟毫秒数,默认为0L,
        4.6.4、multiplier:(指定延迟倍数)默认为0;大于0时生效;如果delay等于2,multiplier等于2,则第一次重试为2秒,第二次为4秒,第三次为6秒…
        4.6.5、random:随机值加权,默认为false;当multiplier>0时,上次延迟毫秒 < 延迟时间 < 最大延迟 * multiplier

5、本例最终效果

1、如果是:NullPointerException 或 RuntimeException 异常,则发起重试
        1.0、刚开始进来的时候算一次
        1.1、第一次延迟 1000 毫秒
        1.2、第二次延迟 1000 * 2 毫秒
        1.3、第三次延迟 1000 * 2 * 2 毫秒
        1.4、第四次延迟 1000 * 2 * 2 * 2 毫秒
        1.5、如果(1+4)次都是异常,则直接结束重试,并抛出异常
2、如果是:Exception 异常,则不进行重试,直接结束,并抛出异常

参考文章1:@Retryable注解,优雅的实现循环重试功能_拾 -.-的博客-CSDN博客

参考文章2:https://www.cnblogs.com/waynaqua/p/17649196.html

你可能感兴趣的:(编程,项目经验,springboot,spring,java,spring,boot)