Class DefaultAdaptiveRetryStrategy

java.lang.Object

software.amazon.awssdk.retries.internal.BaseRetryStrategy

software.amazon.awssdk.retries.internal.DefaultAdaptiveRetryStrategy

All Implemented Interfaces:

AutoCloseable, AdaptiveRetryStrategy, RetryStrategy, DefaultAwareRetryStrategy, SdkAutoCloseable

@SdkInternalApi
public final class DefaultAdaptiveRetryStrategy
extends BaseRetryStrategy
implements AdaptiveRetryStrategy

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DefaultAdaptiveRetryStrategy.Builder

Method Summary

Modifier and Type	Method	Description
AcquireInitialTokenResponse	acquireInitialToken(AcquireInitialTokenRequest request)	This method implements the logic of RetryStrategy.acquireInitialToken(AcquireInitialTokenRequest).
CompletableFuture<AcquireInitialTokenResponse>	acquireInitialTokenAsync(AcquireInitialTokenRequest request)	Acquire a retry token asynchronously.
static DefaultAdaptiveRetryStrategy.Builder	builder()
void	close()
RefreshRetryTokenResponse	refreshRetryToken(RefreshRetryTokenRequest request)	This method implements the logic of RetryStrategy.refreshRetryToken(RefreshRetryTokenRequest).
CompletableFuture<RefreshRetryTokenResponse>	refreshRetryTokenAsync(RefreshRetryTokenRequest request)	Refresh a retry token asynchronously.
DefaultAdaptiveRetryStrategy.Builder	toBuilder()	Create a new RetryStrategy.Builder with the current configuration.

Methods inherited from class software.amazon.awssdk.retries.internal.BaseRetryStrategy

addDefaults, hasRetryPredicates, maxAttempts, recordSuccess, retryPredicates, shouldAddDefaults, toString, useClientDefaults

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awssdk.retries.api.RetryStrategy

maxAttempts, recordSuccess, useClientDefaults

Method Details

acquireInitialToken

public AcquireInitialTokenResponse acquireInitialToken(AcquireInitialTokenRequest request)

Description copied from class: BaseRetryStrategy

This method implements the logic of RetryStrategy.acquireInitialToken(AcquireInitialTokenRequest).

Specified by:

acquireInitialToken in interface RetryStrategy

Overrides:

acquireInitialToken in class BaseRetryStrategy

See Also:

• RetryStrategy.acquireInitialToken(AcquireInitialTokenRequest)

refreshRetryToken

public RefreshRetryTokenResponse refreshRetryToken(RefreshRetryTokenRequest request)

Description copied from class: BaseRetryStrategy

This method implements the logic of RetryStrategy.refreshRetryToken(RefreshRetryTokenRequest).

Specified by:

refreshRetryToken in interface RetryStrategy

Overrides:

refreshRetryToken in class BaseRetryStrategy

See Also:

• RetryStrategy.refreshRetryToken(RefreshRetryTokenRequest)

acquireInitialTokenAsync

public CompletableFuture<AcquireInitialTokenResponse> acquireInitialTokenAsync(AcquireInitialTokenRequest request)

Description copied from interface: RetryStrategy

Acquire a retry token asynchronously. Invoked before the first request attempt.

Callers MUST wait for the delay returned by this call before making the first attempt. Callers that wish to retry a failed attempt MUST call RetryStrategy.refreshRetryToken(software.amazon.awssdk.retries.api.RefreshRetryTokenRequest) before doing so.

If the attempt was successful, callers MUST call RetryStrategy.recordSuccess(software.amazon.awssdk.retries.api.RecordSuccessRequest).

The future is completed exceptionally with NullPointerException if a required parameter is null.

The future is completed exceptionally with TokenAcquisitionFailedException if a token cannot be acquired.

Specified by:

acquireInitialTokenAsync in interface RetryStrategy

refreshRetryTokenAsync

public CompletableFuture<RefreshRetryTokenResponse> refreshRetryTokenAsync(RefreshRetryTokenRequest request)

Description copied from interface: RetryStrategy

Refresh a retry token asynchronously. Invoked before each subsequent (non-first) request attempt.

Callers MUST wait for the delay returned by this call before making the next attempt. If the next attempt fails, callers MUST re-call RetryStrategy.refreshRetryToken(software.amazon.awssdk.retries.api.RefreshRetryTokenRequest) before attempting another retry. This call invalidates the provided token, and returns a new one. Callers MUST use the new token.

If the attempt was successful, callers MUST call RetryStrategy.recordSuccess(software.amazon.awssdk.retries.api.RecordSuccessRequest).

The future is completed exceptionally with NullPointerException if a required parameter is not specified.

The future is completed exceptionally with IllegalArgumentException if the provided token was not issued by this strategy or the provided token was already used for a previous refresh or success call.

The future is completed exceptionally with TokenAcquisitionFailedException if a token cannot be acquired.

Specified by:

refreshRetryTokenAsync in interface RetryStrategy

close

public void close()

Description copied from interface: SdkAutoCloseable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface RetryStrategy

Specified by:

close in interface SdkAutoCloseable

toBuilder

public DefaultAdaptiveRetryStrategy.Builder toBuilder()

Description copied from interface: RetryStrategy

Create a new RetryStrategy.Builder with the current configuration.

This is useful for modifying the strategy's behavior, like conditions or max retries.

Specified by:

toBuilder in interface AdaptiveRetryStrategy

Specified by:

toBuilder in interface RetryStrategy

builder

public static DefaultAdaptiveRetryStrategy.Builder builder()