public class ExponentialRetryAlgorithm implements TimedRetryAlgorithmWithContextThe timed retry algorithm which uses jittered exponential backoff factor for calculating the next attempt execution time.
This class is thread-safe.
Implements
TimedRetryAlgorithmWithContextConstructors
ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)
public ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)Creates a new exponential retry algorithm instance.
| Name | Description |
| globalSettings | RetrySettingsglobal retry settings (attempt independent) |
| clock | com.google.api.core.ApiClockclock to use for time-specific calculations |
Methods
createFirstAttempt()
public TimedAttemptSettings createFirstAttempt()Creates a first attempt TimedAttemptSettings. The first attempt is configured to be executed immediately.
| Type | Description |
| TimedAttemptSettings | first attempt settings |
createFirstAttempt(RetryingContext context)
public TimedAttemptSettings createFirstAttempt(RetryingContext context)Creates a first attempt TimedAttemptSettings. The first attempt is configured to be executed immediately.
| Name | Description |
| context | RetryingContexta RetryingContext that can contain custom RetrySettings and retryable codes |
| Type | Description |
| TimedAttemptSettings | first attempt settings |
createNextAttempt(RetryingContext context, TimedAttemptSettings previousSettings)
public TimedAttemptSettings createNextAttempt(RetryingContext context, TimedAttemptSettings previousSettings)Creates a next attempt TimedAttemptSettings. The implementation increments the current attempt count and uses randomized exponential backoff factor for calculating next attempt execution time.
| Name | Description |
| context | RetryingContexta RetryingContext that can contain custom RetrySettings and retryable codes |
| previousSettings | TimedAttemptSettingsprevious attempt settings |
| Type | Description |
| TimedAttemptSettings | next attempt settings |
createNextAttempt(TimedAttemptSettings previousSettings)
public TimedAttemptSettings createNextAttempt(TimedAttemptSettings previousSettings)Creates a next attempt TimedAttemptSettings. The implementation increments the current attempt count and uses randomized exponential backoff factor for calculating next attempt execution time.
| Name | Description |
| previousSettings | TimedAttemptSettingsprevious attempt settings |
| Type | Description |
| TimedAttemptSettings | next attempt settings |
nextRandomLong(long bound)
protected long nextRandomLong(long bound)| Name | Description |
| bound | long |
| Type | Description |
| long |
shouldRetry(RetryingContext context, TimedAttemptSettings nextAttemptSettings)
public boolean shouldRetry(RetryingContext context, TimedAttemptSettings nextAttemptSettings)Returns true if another attempt should be made, or false otherwise.
| Name | Description |
| context | RetryingContexta RetryingContext that can contain custom RetrySettings and retryable codes. Ignored by this implementation. |
| nextAttemptSettings | TimedAttemptSettingsattempt settings, which will be used for the next attempt, if accepted |
| Type | Description |
| boolean |
|
shouldRetry(TimedAttemptSettings nextAttemptSettings)
public boolean shouldRetry(TimedAttemptSettings nextAttemptSettings)Returns true if another attempt should be made, or false otherwise.
| Name | Description |
| nextAttemptSettings | TimedAttemptSettingsattempt settings, which will be used for the next attempt, if accepted |
| Type | Description |
| boolean |
|