モジュール spring.retry
パッケージ org.springframework.retry.policy

クラス MaxAttemptsRetryPolicy

java.lang.ObjectSE
org.springframework.retry.policy.MaxAttemptsRetryPolicy
実装済みのインターフェース一覧:
SerializableSE, RetryPolicy
public class MaxAttemptsRetryPolicy extends ObjectSE implements RetryPolicy
試行回数のみを認識し、固定回数再試行するシンプルな再試行ポリシー。試行回数には最初の試行も含まれます。

通常、例外分類が強く推奨されるため (たとえば、OutOfMemoryError で再試行しないなど)、これを直接使用することはお勧めしません。

日常的な使用については RetryTemplate.builder() を参照してください

maxAttempts の揮発性により同時変更が可能になり、構築後に新しいインスタンスを安全に公開する必要がなくなります。

関連事項:

  • フィールドの詳細

    • DEFAULT_MAX_ATTEMPTS

      public static final int DEFAULT_MAX_ATTEMPTS
      新しいポリシーの試行回数のデフォルトの制限。
      関連事項:

  • コンストラクターの詳細

    • MaxAttemptsRetryPolicy

      public MaxAttemptsRetryPolicy()
      デフォルトの再試行回数 (3) で MaxAttemptsRetryPolicy を作成し、すべてのスロー可能オブジェクトを再試行します。

    • MaxAttemptsRetryPolicy

      public MaxAttemptsRetryPolicy(int maxAttempts)
      指定された再試行回数で MaxAttemptsRetryPolicy を作成し、すべてのスロー可能なオブジェクトを再試行します。
      パラメーター:
      maxAttempts - 最大試行回数

  • 方法の詳細

    • setMaxAttempts

      public void setMaxAttempts(int maxAttempts)
      再試行が完了するまでの試行回数を設定します。再試行開始前の最初の試行も含まれるため、通常は >= 1 になります。たとえば、このプロパティを 3 に設定すると、合計 3 回の試行 (最初の試行 + 2 回の再試行) が行われます。
      パラメーター:
      maxAttempts - 最初の試行を含む最大試行回数。

    • getMaxAttempts

      public int getMaxAttempts()
      失敗するまでの最大試行回数。
      次で指定:
      インターフェース RetryPolicy 内の getMaxAttempts 
      戻り値:
      最大試行回数

    • canRetry

      public boolean canRetry(RetryContext context)
      ステータスに基づいて再試行可能な操作をテストします。
      次で指定:
      インターフェース RetryPolicy 内の canRetry 
      パラメーター:
      context - 現在の再試行ステータス
      戻り値:
      最後の例外が再試行可能であり、これまでの試行回数が制限未満である場合は true です。
      関連事項:

    • close

      public void close(RetryContext status)
      次で指定:
      インターフェース RetryPolicy 内の close 
      パラメーター:
      status - このポリシーの RetryPolicy.open(RetryContext) メソッドによって作成された再試行ステータス。

    • registerThrowable

      public void registerThrowable(RetryContext context, ThrowableSE throwable)
      別の再試行と最新の例外でステータスを更新します。
      次で指定:
      インターフェース RetryPolicy 内の registerThrowable 
      パラメーター:
      context - 現在のステータスオブジェクト。
      throwable - スローする例外
      関連事項:

    • open

      public RetryContext open(RetryContext parent)
      このポリシーに従って現在の操作を追跡するために使用できるステータスオブジェクトを取得します。最新の例外と試行回数に注意する必要があります。
      次で指定:
      インターフェース RetryPolicy 内の open 
      パラメーター:
      parent - ネストされた再試行の場合は親コンテキスト。
      戻り値:
      このポリシーに固有の RetryContext オブジェクト。
      関連事項: