All Superinterfaces:: Buildable, SdkBuilder<B,T>

Enclosing interface:: RetryStrategy

public static interface RetryStrategy.Builder<B extends RetryStrategy.Builder<B,T>,T extends RetryStrategy>
extends SdkBuilder<B,T>

Builder to create immutable instances of RetryStrategy.

Method Summary

All Methods Instance Methods Abstract Methods Default Methods
Modifier and Type	Method	Description
`B`	`backoffStrategy(BackoffStrategy backoffStrategy)`	Configure the backoff strategy used by the retry strategy.
`T`	`build()`	Build a new `RetryStrategy` with the current configuration on this builder.
`B`	`maxAttempts(int maxAttempts)`	Configure the maximum number of attempts used by the retry strategy.
`default B`	`retryOnException(Class<? extends Throwable> throwable)`	Configure the strategy to retry when a failure exception class is equal to the provided class.
`B`	`retryOnException(Predicate<Throwable> shouldRetry)`	Configure the strategy to retry when the provided predicate returns true, given a failure exception.
`default B`	`retryOnExceptionInstanceOf(Class<? extends Throwable> throwable)`	Configure the strategy to retry when a failure exception class is an instance of the provided class (includes subtypes).
`default B`	`retryOnExceptionOrCause(Class<? extends Throwable> throwable)`	Configure the strategy to retry when a failure exception or one of its cause classes is equal to the provided class.
`default B`	`retryOnExceptionOrCauseInstanceOf(Class<? extends Throwable> throwable)`	Configure the strategy to retry when a failure exception or one of its cause classes is an instance of the provided class (includes subtypes).
`default B`	`retryOnRootCause(Class<? extends Throwable> throwable)`	Configure the strategy to retry the root cause of a failure (the final cause) a failure exception is equal to the provided class.
`default B`	`retryOnRootCauseInstanceOf(Class<? extends Throwable> throwable)`	Configure the strategy to retry the root cause of a failure (the final cause) a failure exception is an instance of to the provided class (includes subtypes).
`B`	`throttlingBackoffStrategy(BackoffStrategy throttlingBackoffStrategy)`	Configure the backoff strategy used for throttling exceptions by this strategy.
`B`	`treatAsThrottling(Predicate<Throwable> treatAsThrottling)`	Configure a predicate that determines whether a retryable exception is a throttling exception.
`default B`	`useClientDefaults(boolean useClientDefaults)`	Configure whether the default predicates should be used, or not.

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation

- Method Detail
  - retryOnException
```
B retryOnException(Predicate<Throwable> shouldRetry)
```
    Configure the strategy to retry when the provided predicate returns true, given a failure exception.
  - retryOnException
```
default B retryOnException(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry when a failure exception class is equal to the provided class.
  - retryOnExceptionInstanceOf
```
default B retryOnExceptionInstanceOf(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry when a failure exception class is an instance of the provided class (includes subtypes).
  - retryOnExceptionOrCause
```
default B retryOnExceptionOrCause(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry when a failure exception or one of its cause classes is equal to the provided class.
  - retryOnExceptionOrCauseInstanceOf
```
default B retryOnExceptionOrCauseInstanceOf(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry when a failure exception or one of its cause classes is an instance of the provided class (includes subtypes).
  - retryOnRootCause
```
default B retryOnRootCause(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry the root cause of a failure (the final cause) a failure exception is equal to the provided class.
  - retryOnRootCauseInstanceOf
```
default B retryOnRootCauseInstanceOf(Class<? extends Throwable> throwable)
```
    Configure the strategy to retry the root cause of a failure (the final cause) a failure exception is an instance of to the provided class (includes subtypes).
  - maxAttempts
```
B maxAttempts(int maxAttempts)
```
    Configure the maximum number of attempts used by the retry strategy.
    The actual number of attempts made may be less, depending on the retry strategy implementation. For example, the standard and adaptive retry modes both employ short-circuiting which reduces the maximum attempts during outages.
    The default value for the standard and adaptive retry strategies is 3.
  - backoffStrategy
```
B backoffStrategy(BackoffStrategy backoffStrategy)
```
    Configure the backoff strategy used by the retry strategy.
    By default, this uses jittered exponential backoff.
  - throttlingBackoffStrategy
```
B throttlingBackoffStrategy(BackoffStrategy throttlingBackoffStrategy)
```
    Configure the backoff strategy used for throttling exceptions by this strategy.
    By default, this uses jittered exponential backoff.
  - treatAsThrottling
```
B treatAsThrottling(Predicate<Throwable> treatAsThrottling)
```
    Configure a predicate that determines whether a retryable exception is a throttling exception. When this predicate returns true, the retry strategy will use the throttlingBackoffStrategy(software.amazon.awssdk.retries.api.BackoffStrategy). If it returns false, the backoffStrategy(software.amazon.awssdk.retries.api.BackoffStrategy) will be used. This predicate will not be called for non-retryable exceptions.
  - useClientDefaults
```
default B useClientDefaults(boolean useClientDefaults)
```
    Configure whether the default predicates should be used, or not. When set to false, only user-provided retry predicates will be considered to determine what should be retried or not. Setting this to false and providing no predicate will result in an empty retry strategy.
  - build
```
T build()
```
    Build a new RetryStrategy with the current configuration on this builder.
    
    Specified by:
    
    build in interface Buildable
    
    Specified by:
    
    build in interface SdkBuilder<B extends RetryStrategy.Builder<B,T>,T extends RetryStrategy>

Interface RetryStrategy.Builder<B extends RetryStrategy.Builder<B,​T>,​T extends RetryStrategy>

Method Summary

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

Method Detail

retryOnException

retryOnException

retryOnExceptionInstanceOf

retryOnExceptionOrCause

retryOnExceptionOrCauseInstanceOf

retryOnRootCause

retryOnRootCauseInstanceOf

maxAttempts

backoffStrategy

throttlingBackoffStrategy

treatAsThrottling

useClientDefaults

build

Interface RetryStrategy.Builder<B extends RetryStrategy.Builder<B,T>,T extends RetryStrategy>