spring retry是從spring batch獨立出來的一個能功能,主要實現了重試和熔斷。這篇文章主要介紹了詳解重試框架Spring retry實踐,具有一定的參考價值,感興趣的小夥伴們可以參考一下
spring retry是從spring batch獨立出來的一個能功能,主要實現了重試和熔斷。對於重試是有場景限制的,不是什麼場景都適合重試,比如參數校驗不合法、寫操作等(要考慮寫是否冪等)都不適合重試。遠程調用超時、網絡突然中斷可以重試。在微服務治理框架中,通常都有自己的重試與超時配置,比如dubbo可以設置retries=1,timeout=500調用失敗只重試1次,超過500ms調用仍未返回則調用失敗。在spring retry中可以指定需要重試的異常類型,並設置每次重試的間隔以及如果重試失敗是繼續重試還是熔斷(停止重試)。
設計與實現
RetryOperations
定義重試的API,RetryTemplate
是API的模板模式實現,實現了重試和熔斷。提供的API如下:
- public interface RetryOperations {
- <T, E extends Throwable>T execute(RetryCallback<T, E>retryCallback) throws E;
- }
- // 其他API已省略
RetryCallback
定義了需要執行重試的操作,定義好操作後,就是如何重試的問題了。RetryTemplate
通過制定不同的重試策略來執行如何重試的邏輯。默認的重試策略是SimpleRetryPlicy
,也就是會重試3次。重試第1次如果成功後面就不會繼續重試了。那麼如果3尺都重試失敗了呢?流程結束或者返回兜底結果。要返回兜底結果需要配置RecoveyCallBack
,從名字可以看出這是一個兜底回調接口,也就是重試失敗後執行的邏輯。除了SimpleRetryPolicy
還有其他重試策略,先來看下RetryPolicy
接口:
- public interface RetryPolicy extends Serializable {
- boolean canRetry(RetryContext context);
- RetryContext open(RetryContext parent);
- void close(RetryContext context);
- void registerThrowable(RetryContext context, Throwable throwable);
- }
canRetry
在每次重試的時候調用,是否可以繼續重試的判斷條件open
重試開始前調用,會創建一個重試上下文到RetryContext
,保存重試的堆棧等信息registerThrowable
每次重試異常時調用(有異常會繼續重試)
以SimpleRetryPolicy
爲例,當重試次數達到3(默認3次)停止重試,重試次數保存在重試上下文中。
提供如下重試策略實現:
- NeverRetryPolicy:只允許調用RetryCallback一次,不允許重試
- AlwaysRetryPolicy:允許無限重試,直到成功,此方式邏輯不當會導致死循環
- SimpleRetryPolicy:固定次數重試策略,默認重試最大次數爲3次,RetryTemplate默認使用的策略
- TimeoutRetryPolicy:超時時間重試策略,默認超時時間爲1秒,在指定的超時時間內允許重試
- ExceptionClassifierRetryPolicy:設置不同異常的重試策略,類似組合重試策略,區別在於這裏只區分不同異常的重試
- CircuitBreakerRetryPolicy:有熔斷功能的重試策略,需設置3個參數openTimeout、resetTimeout和delegate
- CompositeRetryPolicy:組合重試策略,有兩種組合方式,樂觀組合重試策略是指只要有一個策略允許重試即可以,悲觀組合重試策略是指只要有一個策略不允許重試即可以,但不管哪種組合方式,組合中的每一個策略都會執行
重試回退策略,指的是每次重試是立即重試還是等待一段時間後重試。默認情況下是立即重試,如果需要配置等待一段時間後重試則需要指定回退策略BackoffRetryPolicy
。BackoffRetryPolicy有如下實現:
- NoBackOffPolicy:無退避算法策略,每次重試時立即重試
- FixedBackOffPolicy:固定時間的退避策略,需設置參數sleeper和backOffPeriod,sleeper指定等待策略,默認是Thread.sleep,即線程休眠,backOffPeriod指定休眠時間,默認1秒
- UniformRandomBackOffPolicy:隨機時間退避策略,需設置sleeper、minBackOffPeriod和maxBackOffPeriod,該策略在[minBackOffPeriod,maxBackOffPeriod之間取一個隨機休眠時間,minBackOffPeriod默認500毫秒,maxBackOffPeriod默認1500毫秒
- ExponentialBackOffPolicy:指數退避策略,需設置參數sleeper、initialInterval、maxInterval和multiplier,initialInterval指定初始休眠時間,默認100毫秒,maxInterval指定最大休眠時間,默認30秒,multiplier指定乘數,即下一次休眠時間爲當前休眠時間*multiplier
- ExponentialRandomBackOffPolicy:隨機指數退避策略,引入隨機乘數可以實現隨機乘數回退
有狀態重試 OR 無狀態重試
所謂無狀態重試是指重試在一個線程上下文中完成的重試,反之不在一個線程上下文完成重試的就是有狀態重試。之前的SimpleRetryPolicy
就屬於無狀態重試,因爲重試是在一個循環中完成的。那麼什麼會後會出現或者說需要有狀態重試呢?通常有兩種情況:事務回滾和熔斷。
數據庫操作異常DataAccessException,不能執行重試,而如果拋出其他異常可以重試。
熔斷的意思不在當前循環中處理重試,而是全局重試模式(不是線程上下文)。熔斷會跳出循環,那麼必然會丟失線程上下文的堆棧信息。那麼肯定需要一種“全局模式”保存這種信息,目前的實現放在一個cache(map實現的)中,下次從緩存中獲取就能繼續重試了。
Quick Start
在需要執行重試的類上使用@EnableRetry
,如果設置了proxyTargetClass=true
這使用CGLIB動態代理:
- @Configuration
- @EnableRetry(proxyTargetClass = true)
- @Component
- public class RetryExamples {
- }
基於最大重試次數策略的重試,如果重試了3次仍然拋出異常則停止重試,執行兜底回調,所以最後的輸出結果是Integer.MAX_VALUE
:
- private void retryExample3() throws Exception {
- RetryTemplate retryTemplate = new RetryTemplate();
- SimpleRetryPolicy simpleRetryPolicy = new SimpleRetryPolicy();
- simpleRetryPolicy.setMaxAttempts(3);
- retryTemplate.setRetryPolicy(simpleRetryPolicy);
- Integer result = retryTemplate.execute(new RetryCallback<Integer, Exception>() {
- int i = 0;
- // 重試操作
- @Override
- public Integer doWithRetry(RetryContext retryContext) throws Exception {
- log.info("retry count: {}", retryContext.getRetryCount());
- return len(i++);
- }
- }, new RecoveryCallback<Integer>() { //兜底回調
- @Override
- public Integer recover(RetryContext retryContext) throws Exception {
- log.info("after retry: {}, recovery method called!", retryContext.getRetryCount());
- return Integer.MAX_VALUE;
- }
- });
- log.info("final result: {}", result);
- }
- private int len(int i) throws Exception {
- if (i < 10) throw new Exception(i + " le 10");
- return i;
- }
下面介紹如何使用熔斷重試策略模式(CircuitBreakerRetryPolicy),需要設置如下三個參數:
- delegate:傳入RetryPolicy(每個RetryPolicy實現都有自己的重試策略實現),是真正判斷是否重試的策略,當重試失敗時,則執行熔斷策略
- openTimeout:openWindow,配置熔斷器電路打開的超時時間,當超過openTimeout之後熔斷器電路變成半打開狀態(只要有一次重試成功,則閉合電路)
- resetTimeout:timeout,配置重置熔斷器重新閉合的超時時間
斷路器開閉實現判斷:
- 當重試失敗,且在熔斷器打開時間窗口[0,openWindow) 內,立即熔斷
- 當重試失敗,且超過timeout,熔斷器電路重新閉合
- 在熔斷器半打開狀態[openWindow, timeout] 時,只要重試成功則重置上下文,斷路器閉合
測試代碼如下:
- RetryTemplate template = new RetryTemplate();
- CircuitBreakerRetryPolicy retryPolicy =
- new CircuitBreakerRetryPolicy(new SimpleRetryPolicy(3));
- retryPolicy.setOpenTimeout(5000);
- retryPolicy.setResetTimeout(20000);
- template.setRetryPolicy(retryPolicy);
- for (int i = 0; i < 10; i++) {
- //Thread.sleep(100);
- try {
- Object key = "circuit";
- boolean isForceRefresh = false;
- RetryState state = new DefaultRetryState(key, isForceRefresh);
- String result = template.execute(new RetryCallback<String, RuntimeException>() {
- @Override
- public String doWithRetry(RetryContext context) throws RuntimeException {
- log.info("retry count: {}", context.getRetryCount());
- throw new RuntimeException("timeout");
- }
- }, new RecoveryCallback<String>() {
- @Override
- public String recover(RetryContext context) throws Exception {
- return "default";
- }
- }, state);
- log.info("result: {}", result);
- } catch (Exception e) {
- System.out.println(e);
- }
- }
這裏由於設置了isForceRefresh = false
,則key = "circuit"
的值(也就是RetryContext)會從緩存中獲取,所以當重試失敗且滿足this.time < this.openWindow
發生熔斷的時候,後面仍然可以繼續已全局模式實現重試(拿到的RetryContext
是同一個)。
註解開發
如果每次有重試需求的時候都寫一個RetryTemplate
太臃腫了,使用註解可以大大簡化開發,減少重複代碼。下面是一個使用註解實現的最大重試策略的重試:
- @Retryable(value = SQLDataException.class, backoff = @Backoff(value = 0L))
- public String service3() throws SQLDataException {
- log.info("service3 open");
- throw new SQLDataException();
- }
- @Recover
- public String recover(SQLDataException ne) {
- return "SQLDataException recover";
- }
註解包括:
@EnableRetry
@Retryable
@Recover
@Backoff
@CircuitBreaker
@EnableRetry:能否重試,proxyTargetClass屬性爲true時(默認false),使用CGLIB代理
@Retryable:註解需要被重試的方法
- include 指定處理的異常類。默認爲空
- exclude指定不需要處理的異常。默認爲空
- vaue指定要重試的異常。默認爲空
- maxAttempts 最大重試次數。默認3次
- backoff 重試等待策略。默認使用@Backoff註解
@Backoff:重試回退策略(立即重試還是等待一會再重試)
- 不設置參數時,默認使用FixedBackOffPolicy,重試等待1000ms
- 只設置delay()屬性時,使用FixedBackOffPolicy,重試等待指定的毫秒數
- 當設置delay()和maxDealy()屬性時,重試等待在這兩個值之間均態分佈
- 使用delay(),maxDealy()和multiplier()屬性時,使用ExponentialBackOffPolicy
- 當設置multiplier()屬性不等於0時,同時也設置了random()屬性時,使用ExponentialRandomBackOffPolicy
@Recover: 用於方法。用於@Retryable失敗時的“兜底”處理方法。 @Recover註釋的方法必須要與@Retryable註解的方法“簽名”保持一致,第一入參爲要重試的異常,其他參數與@Retryable保持一致,返回值也要一樣,否則無法執行!
@CircuitBreaker:用於方法,實現熔斷模式。
- include 指定處理的異常類。默認爲空
- exclude指定不需要處理的異常。默認爲空
- vaue指定要重試的異常。默認爲空
- maxAttempts 最大重試次數。默認3次
- openTimeout 配置熔斷器打開的超時時間,默認5s,當超過openTimeout之後熔斷器電路變成半打開狀態(只要有一次重試成功,則閉合電路)
- resetTimeout 配置熔斷器重新閉合的超時時間,默認20s,超過這個時間斷路器關閉
更多的例子歡迎到我的Github(https://github.com/happyxiaofan/springboot-learning-example) star。謝謝
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持我們。
本文標題: 詳解重試框架Spring retry實踐
本文地址: http://www.cppcns.com/ruanjian/java/227353.html