com.google.api.gax.retrying

Interface TimedRetryAlgorithm

All Known Implementing Classes:

ExponentialRetryAlgorithm

@BetaApi
public interface TimedRetryAlgorithm

A timed retry algorithm is responsible for the following operations:

1. Creating first attempt TimedAttemptSettings.
2. Accepting or rejecting a task for retry depending on the previous attempt settings and current time.
3. Creating TimedAttemptSettings for each subsequent retry attempt.

Implementations of this interface must be be thread-save.

Method Summary

Modifier and Type	Method and Description
boolean	accept(TimedAttemptSettings nextAttemptSettings) Returns true if another attempt should be made, or false otherwise.
TimedAttemptSettings	createFirstAttempt() Creates a first attempt TimedAttemptSettings.
TimedAttemptSettings	createNextAttempt(TimedAttemptSettings prevSettings) Creates a next attempt TimedAttemptSettings, which defines properties of the next attempt.

Method Detail

createFirstAttempt

TimedAttemptSettings createFirstAttempt()

Creates a first attempt TimedAttemptSettings.

Returns:

first attempt settings

createNextAttempt

TimedAttemptSettings createNextAttempt(TimedAttemptSettings prevSettings)

Creates a next attempt TimedAttemptSettings, which defines properties of the next attempt.

Parameters:

prevSettings - previous attempt settings

Returns:

next attempt settings or null if the implementing algorithm does not provide specific settings for the next attempt

accept

boolean accept(TimedAttemptSettings nextAttemptSettings)

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

Parameters:

nextAttemptSettings - attempt settings, which will be used for the next attempt, if accepted