Class ExponentialBackOff.Builder (1.43.1)

public static class ExponentialBackOff.Builder

Builder for ExponentialBackOff.

Implementation is not thread-safe.

Inheritance

java.lang.Object > ExponentialBackOff.Builder

Constructors

Builder()

public Builder()

Methods

build()

public ExponentialBackOff build()

Builds a new instance of ExponentialBackOff.

Returns
TypeDescription
ExponentialBackOff

getInitialIntervalMillis()

public final int getInitialIntervalMillis()

Returns the initial retry interval in milliseconds. The default value is #DEFAULT_INITIAL_INTERVAL_MILLIS.

Returns
TypeDescription
int

getMaxElapsedTimeMillis()

public final int getMaxElapsedTimeMillis()

Returns the maximum elapsed time in milliseconds. The default value is #DEFAULT_MAX_ELAPSED_TIME_MILLIS.

If the time elapsed since an ExponentialBackOff instance is created goes past the max_elapsed_time then the method #nextBackOffMillis() starts returning BackOff#STOP. The elapsed time can be reset by calling #reset().

Returns
TypeDescription
int

getMaxIntervalMillis()

public final int getMaxIntervalMillis()

Returns the maximum value of the back off period in milliseconds. Once the current interval reaches this value it stops increasing. The default value is #DEFAULT_MAX_INTERVAL_MILLIS. Must be >= initialInterval.

Returns
TypeDescription
int

getMultiplier()

public final double getMultiplier()

Returns the value to multiply the current interval with for each retry attempt. The default value is #DEFAULT_MULTIPLIER.

Returns
TypeDescription
double

getNanoClock()

public final NanoClock getNanoClock()

Returns the nano clock.

Returns
TypeDescription
NanoClock

getRandomizationFactor()

public final double getRandomizationFactor()

Returns the randomization factor to use for creating a range around the retry interval. The default value is #DEFAULT_RANDOMIZATION_FACTOR.

A randomization factor of 0.5 results in a random period ranging between 50% below and 50% above the retry interval.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Returns
TypeDescription
double

setInitialIntervalMillis(int initialIntervalMillis)

public ExponentialBackOff.Builder setInitialIntervalMillis(int initialIntervalMillis)

Sets the initial retry interval in milliseconds. The default value is #DEFAULT_INITIAL_INTERVAL_MILLIS. Must be > 0.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
initialIntervalMillisint
Returns
TypeDescription
ExponentialBackOff.Builder

setMaxElapsedTimeMillis(int maxElapsedTimeMillis)

public ExponentialBackOff.Builder setMaxElapsedTimeMillis(int maxElapsedTimeMillis)

Sets the maximum elapsed time in milliseconds. The default value is #DEFAULT_MAX_ELAPSED_TIME_MILLIS. Must be > 0.

If the time elapsed since an ExponentialBackOff instance is created goes past the max_elapsed_time then the method #nextBackOffMillis() starts returning BackOff#STOP. The elapsed time can be reset by calling #reset().

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
maxElapsedTimeMillisint
Returns
TypeDescription
ExponentialBackOff.Builder

setMaxIntervalMillis(int maxIntervalMillis)

public ExponentialBackOff.Builder setMaxIntervalMillis(int maxIntervalMillis)

Sets the maximum value of the back off period in milliseconds. Once the current interval reaches this value it stops increasing. The default value is #DEFAULT_MAX_INTERVAL_MILLIS.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
maxIntervalMillisint
Returns
TypeDescription
ExponentialBackOff.Builder

setMultiplier(double multiplier)

public ExponentialBackOff.Builder setMultiplier(double multiplier)

Sets the value to multiply the current interval with for each retry attempt. The default value is #DEFAULT_MULTIPLIER. Must be >= 1.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
multiplierdouble
Returns
TypeDescription
ExponentialBackOff.Builder

setNanoClock(NanoClock nanoClock)

public ExponentialBackOff.Builder setNanoClock(NanoClock nanoClock)

Sets the nano clock (NanoClock#SYSTEM by default).

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
nanoClockNanoClock
Returns
TypeDescription
ExponentialBackOff.Builder

setRandomizationFactor(double randomizationFactor)

public ExponentialBackOff.Builder setRandomizationFactor(double randomizationFactor)

Sets the randomization factor to use for creating a range around the retry interval. The default value is #DEFAULT_RANDOMIZATION_FACTOR. Must fall in the range 0 <= randomizationFactor < 1.

A randomization factor of 0.5 results in a random period ranging between 50% below and 50% above the retry interval.

Overriding is only supported for the purpose of calling the super implementation and changing the return type, but nothing else.

Parameter
NameDescription
randomizationFactordouble
Returns
TypeDescription
ExponentialBackOff.Builder