Class ExponentialRetryAlgorithm (2.16.0)

Version 2.16.0

• 2.59.0 (latest)
• 2.58.0
• 2.57.0
• 2.55.0
• 2.54.1
• 2.53.0
• 2.52.0
• 2.51.0
• 2.50.0
• 2.49.0
• 2.48.1
• 2.47.0
• 2.46.1
• 2.45.0
• 2.43.0
• 2.42.0
• 2.41.0
• 2.39.0
• 2.38.0
• 2.37.0
• 2.36.0
• 2.35.0
• 2.34.1
• 2.33.0
• 2.32.1
• 2.31.1
• 2.30.1
• 2.24.0
• 2.23.3
• 2.22.0
• 2.21.0
• 2.20.1
• 2.19.6
• 2.18.7
• 2.17.0
• 2.16.0
• 2.15.0
• 2.14.0
• 2.13.0
• 2.12.2
• 2.11.0
• 2.10.0
• 2.9.0
• 2.8.1
• 2.7.1

public class ExponentialRetryAlgorithm implements TimedRetryAlgorithmWithContext

The timed retry algorithm which uses jittered exponential backoff factor for calculating the next attempt execution time.

This class is thread-safe.

Inheritance

java.lang.Object > ExponentialRetryAlgorithm

Implements

TimedRetryAlgorithmWithContext

Inherited Members

Object.clone()

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.toString()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Constructors

ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)

public ExponentialRetryAlgorithm(RetrySettings globalSettings, ApiClock clock)

Creates a new exponential retry algorithm instance.

Parameters

Name	Description
globalSettings	RetrySettings global retry settings (attempt independent)
clock	com.google.api.core.ApiClock clock 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.

Returns

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.

Parameter

Name	Description
context	RetryingContext a RetryingContext that can contain custom RetrySettings and retryable codes

Returns

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.

Parameters

Name	Description
context	RetryingContext a RetryingContext that can contain custom RetrySettings and retryable codes
previousSettings	TimedAttemptSettings previous attempt settings

Returns

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.

Parameter

Name	Description
previousSettings	TimedAttemptSettings previous attempt settings

Returns

Type	Description
TimedAttemptSettings	next attempt settings

nextRandomLong(long bound)

protected long nextRandomLong(long bound)

Parameter

Name	Description
bound	long

Returns

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.

Parameters

Name	Description
context	RetryingContext a RetryingContext that can contain custom RetrySettings and retryable codes. Ignored by this implementation.
nextAttemptSettings	TimedAttemptSettings attempt settings, which will be used for the next attempt, if accepted

Returns

Type	Description
boolean	true if nextAttemptSettings does not exceed either maxAttempts limit or totalTimeout limit, or false otherwise

shouldRetry(TimedAttemptSettings nextAttemptSettings)

public boolean shouldRetry(TimedAttemptSettings nextAttemptSettings)

Returns true if another attempt should be made, or false otherwise.

Parameter

Name	Description
nextAttemptSettings	TimedAttemptSettings attempt settings, which will be used for the next attempt, if accepted

Returns

Type	Description
boolean	true if nextAttemptSettings does not exceed either maxAttempts limit or totalTimeout limit, or false otherwise