Easy-retry是一個Java任務重試框架。

主要特點

• 靈活，可以設定不同的重試策略，比如
  • 發生異常時重試，你可以設定哪些異常被重試、哪些異常被忽略。
  • 返回值不符合預期時重置。

         也可以設定中斷重試的策略，比如達到最大重試次數、達到最多等待時間等。

• 易用
  • 短短几行程式碼就可以重試你的任務。
• 輕量級
  • 除了slf4j、logback日誌框架外，沒有引入任何第三方Jar包。

如何使用

引入依賴

<dependency>
        <groupId>com.github.bournecui</groupId>
        <artifactId>easy-retry</artifactId>
        <version>0.0.1</version>
</dependency>
 

使用EasyRetryBuilder構建EasyRetry例項，它是執行緒安全的，所以在你的程式裡構建一個就可以了。

EasyRetry easyRetry = EasyRetryBuilder.newBuilder()
                 .maxAttempts(10)
                 .includeExceptions(IllegalStateException.class)
                 .build();

使用EasyCallable(有返回值)或者EasyRunnable(沒有返回值)封裝你的任務並用easyRetry執行它。

Integer res1 = easyRetry.call(new EasyCallable<Integer>() {
            @Override
            public Integer call() {
                int aInt = (int) (Math.random() * 10);
                if (aInt % 3 != 0) {
                    throw new IllegalStateException(aInt + " is not expected!");
                }
                return aInt;
            }
        });
 

對於有返回值的任務，你可以使用ResultPredicate判斷返回值是不是你想要的，如果不是你想要的，它會進行重試。

Integer res2 = easyRetry.call(new EasyCallable<Integer>() {
            @Override
            public Integer call() {
                return (int) (Math.random() * 10);
            }
        }, new ResultPredicate<Integer>() {
            @Override
            public boolean test(Integer result) {
                return result % 3 != 0;
            }
        });

如果你使用蘭姆達表示式並static import來匯入com.github.bournecui.easyretry.EasyRetryBuilder.newBuilder，你的程式碼看起來會更簡潔。

newBuilder()
          .maxAttempts(10)
          .includeExceptions(IllegalStateException.class)
          .build()
          .call(() -> (int) (Math.random() * 10), result -> result % 3 != 0);