software.amazon.awssdk.core.retry.backoff

Class EqualJitterBackoffStrategy

java.lang.Object

software.amazon.awssdk.core.retry.backoff.EqualJitterBackoffStrategy

All Implemented Interfaces:

BackoffStrategy, ToCopyableBuilder<EqualJitterBackoffStrategy.Builder,EqualJitterBackoffStrategy>

public final class EqualJitterBackoffStrategy
extends Object
implements BackoffStrategy, ToCopyableBuilder<EqualJitterBackoffStrategy.Builder,EqualJitterBackoffStrategy>

Backoff strategy that uses equal jitter for computing the delay before the next retry. An equal jitter backoff strategy will first compute an exponential delay based on the current number of retries, base delay and max delay. The final computed delay before the next retry will keep half of this computed delay plus a random delay computed as a random number between 0 and half of the exponential delay plus one. For example, using a base delay of 100, a max backoff time of 10000 an exponential delay of 400 is computed for a second retry attempt. The final computed delay before the next retry will be half of the computed exponential delay, in this case 200, plus a random number between 0 and 201. Therefore the range for delay would be between 200 and 401. This is in contrast to FullJitterBackoffStrategy where the final computed delay before the next retry will be between 0 and the computed exponential delay.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EqualJitterBackoffStrategy.Builder

Constructor Summary

Constructors

Constructor and Description
EqualJitterBackoffStrategy(EqualJitterBackoffStrategy.Builder builder)

Method Summary

Modifier and Type	Method and Description
static EqualJitterBackoffStrategy.Builder	builder()
Duration	computeDelayBeforeNextRetry(RetryPolicyContext context) Compute the delay before the next retry request.
EqualJitterBackoffStrategy.Builder	toBuilder() Take this object and create a builder that contains all of the current property values of this object.

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.awssdk.core.retry.backoff.BackoffStrategy

calculateExponentialDelay, defaultStrategy, none

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

copy

Constructor Detail

EqualJitterBackoffStrategy

public EqualJitterBackoffStrategy(EqualJitterBackoffStrategy.Builder builder)

Method Detail

computeDelayBeforeNextRetry

public Duration computeDelayBeforeNextRetry(RetryPolicyContext context)

Description copied from interface: BackoffStrategy

Compute the delay before the next retry request. This strategy is only consulted when there will be a next retry.

Specified by:

computeDelayBeforeNextRetry in interface BackoffStrategy

Parameters:

context - Context about the state of the last request and information about the number of requests made.

Returns:

Amount of time in milliseconds to wait before the next attempt. Must be non-negative (can be zero).

toBuilder

public EqualJitterBackoffStrategy.Builder toBuilder()

Description copied from interface: ToCopyableBuilder

Take this object and create a builder that contains all of the current property values of this object.

Specified by:

toBuilder in interface ToCopyableBuilder<EqualJitterBackoffStrategy.Builder,EqualJitterBackoffStrategy>

Returns:

a builder for type T

builder

public static EqualJitterBackoffStrategy.Builder builder()