インターフェース RetryListener
- すべての既知の実装クラス:
CompositeRetryListener
public interface RetryListener
RetryListener は、Retryable 操作の実行中に公開されたイベントに反応するためのリスナー API を定義します。 通常は RetryTemplate に登録され、CompositeRetryListener を使用して構成できます。
- 導入:
- 7.0
- 作成者:
- Mahmoud Ben Hassine, Sam Brannen, Juergen Hoeller
- 関連事項:
方法の概要
修飾子と型メソッド説明default voidbeforeRetry(RetryPolicy retryPolicy, Retryable<?> retryable) 再試行する前に毎回呼び出されます。default voidbeforeRetry(RetryPolicy retryPolicy, Retryable<?> retryable, RetryState retryState) 再試行する前に毎回呼び出されます。default voidonRetryableExecution(RetryPolicy retryPolicy, Retryable<?> retryable, RetryState retryState) 最初の呼び出しを含むすべての試行の後に呼び出されます。default voidonRetryFailure(RetryPolicy retryPolicy, Retryable<?> retryable, ThrowableSE throwable) 再試行が失敗するたびに呼び出されます。default voidonRetryPolicyExhaustion(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) RetryPolicyが使い果たされた場合に呼び出されます。default voidonRetryPolicyInterruption(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) 再試行の合間にRetryPolicyが中断された場合に呼び出されます。default voidonRetryPolicyTimeout(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) RetryPolicyに設定されたタイムアウトを超えた場合に呼び出されます。default voidonRetrySuccess(RetryPolicy retryPolicy, Retryable<?> retryable, @Nullable ObjectSE result) 最初の再試行が成功した後に呼び出されます。
メソッドの詳細
onRetryableExecution
default void onRetryableExecution(RetryPolicy retryPolicy, Retryable<?> retryable, RetryState retryState) 最初の呼び出しを含むすべての試行の後に呼び出されます。試行が成功したかどうかは
RetryState.isSuccessful()で確認できます。成功しなかった場合は、現在の例外をRetryState.getLastException()でイントロスペクトできます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦retryState- 再試行処理の現在の状態 (これは現在の状態を反映するライブインスタンスであり、保存されることを意図したものではありません)- 導入:
- 7.0.2
- 関連事項:
beforeRetry
再試行する前に毎回呼び出されます。すべての再試行後の対応するコールバックについては、対応する
RetryState.getRetryCount()チェックによる最初の試行を無視して、onRetryableExecution(RetryPolicy, Retryable, RetryState)を検討してください。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦retryState- 再試行処理の現在の状態 (これは現在の状態を反映するライブインスタンスであり、保存されることを意図したものではありません)- 導入:
- 7.0.4
- 関連事項:
beforeRetry
再試行する前に毎回呼び出されます。beforeRetry(RetryPolicy, Retryable, RetryState)によって呼び出されます。この縮小メソッドか、そのフル引数メソッドのいずれかを実装してください。両方を実装しないでください。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦- 関連事項:
onRetrySuccess
default void onRetrySuccess(RetryPolicy retryPolicy, Retryable<?> retryable, @Nullable ObjectSE result) 最初の再試行が成功した後に呼び出されます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦result-Retryable操作の結果
onRetryFailure
再試行が失敗するたびに呼び出されます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦throwable-Retryable操作によってスローされた例外
onRetryPolicyExhaustion
default void onRetryPolicyExhaustion(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) RetryPolicyが使い果たされた場合に呼び出されます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦exception- 結果として得られるRetryException。Retryable操作によってスローされた最後の例外が原因となり、以前の試行からの例外は抑制された例外となります。- 関連事項:
onRetryPolicyInterruption
default void onRetryPolicyInterruption(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) 再試行の合間にRetryPolicyが中断された場合に呼び出されます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦exception- 結果として得られるRetryException。Retryable操作によってスローされた最後の例外が原因となり、以前の試行からの例外は抑制された例外となります。- 関連事項:
onRetryPolicyTimeout
default void onRetryPolicyTimeout(RetryPolicy retryPolicy, Retryable<?> retryable, RetryException exception) RetryPolicyに設定されたタイムアウトを超えた場合に呼び出されます。- パラメーター:
retryPolicy-RetryPolicyretryable-Retryable作戦exception- 結果として得られるRetryException。Retryable操作によってスローされた最後の例外が原因となり、以前の試行からの例外は抑制された例外となります。- 導入:
- 7.0.2
- 関連事項: