Interface ResultRetryAlgorithmWithContext<ResponseT> (2.46.1)

Version latest

• 2.46.1 (latest)
• 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 interface ResultRetryAlgorithmWithContext<ResponseT> extends ResultRetryAlgorithm<ResponseT>

A result retry algorithm is responsible for the following operations (based on the response returned by the previous attempt or on the thrown exception):

1. Accepting a task for retry so another attempt will be made.
2. Canceling retrying process so the related java.util.concurrent.Future will be canceled.
3. Creating TimedAttemptSettings for each subsequent retry attempt.

Implementations of this interface receive a RetryingContext that can contain specific RetrySettings and retryable codes that should be used to determine the retry behavior.

Implementations of this interface must be thread-safe.

Implements

com.google.api.gax.retrying.ResultRetryAlgorithm<ResponseT>

Type Parameter
Name	Description
ResponseT

Methods

createNextAttempt(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse, TimedAttemptSettings previousSettings)

public abstract TimedAttemptSettings createNextAttempt(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse, TimedAttemptSettings previousSettings)

Creates a next attempt TimedAttemptSettings.

Parameters
Name	Description
context	RetryingContext the retrying context of this invocation that can be used to determine the settings for the next attempt.
previousThrowable	Throwable exception thrown by the previous attempt (null, if none)
previousResponse	ResponseT response returned by the previous attempt
previousSettings	TimedAttemptSettings previous attempt settings

Returns
Type	Description
TimedAttemptSettings

shouldRetry(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse)

public abstract boolean shouldRetry(RetryingContext context, Throwable previousThrowable, ResponseT previousResponse)

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

Parameters
Name	Description
context	RetryingContext the retrying context of this invocation that can be used to determine whether the call should be retried.
previousThrowable	Throwable exception thrown by the previous attempt (null, if none)
previousResponse	ResponseT response returned by the previous attempt.

Returns
Type	Description
boolean

Exceptions
Type	Description
CancellationException