Class DirectRetryingExecutor<ResponseT> (2.13.0)

public class DirectRetryingExecutor<ResponseT> implements RetryingExecutorWithContext<ResponseT>

The retry executor which executes attempts in the current thread, potentially causing the current thread to sleep for the specified amount of time before execution.

This class is thread-safe.

Inheritance

java.lang.Object > DirectRetryingExecutor<ResponseT>

Implements

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

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)

Type Parameter

Name	Description
ResponseT

Constructors

DirectRetryingExecutor(RetryAlgorithm<ResponseT> retryAlgorithm)

public DirectRetryingExecutor(RetryAlgorithm<ResponseT> retryAlgorithm)

Creates a new direct retrying executor instance, which will be using retryAlgorithm to determine retrying strategy.

Parameter

Name	Description
retryAlgorithm	`RetryAlgorithm<ResponseT>` retry algorithm to use for attempts execution

Methods

createFuture(Callable<ResponseT> callable)

public RetryingFuture<ResponseT> createFuture(Callable<ResponseT> callable)

Creates a RetryingFuture, which is a facade, returned to the client code to wait for any retriable operation to complete. The future is bounded to this executor instance.

Parameter

Name	Description
callable	`Callable<ResponseT>` the actual callable, which should be executed in a retriable context

Returns

Type	Description
RetryingFuture<ResponseT>	retrying future facade

createFuture(Callable<ResponseT> callable, RetryingContext context)

public RetryingFuture<ResponseT> createFuture(Callable<ResponseT> callable, RetryingContext context)

Creates a RetryingFuture, which is a facade, returned to the client code to wait for any retriable operation to complete. The future is bounded to this executor instance.

Parameters

Name	Description
callable	`Callable<ResponseT>` the actual callable, which should be executed in a retriable context
context	`RetryingContext`

Returns

Type	Description
RetryingFuture<ResponseT>	retrying future facade

sleep(Duration delay)

protected void sleep(Duration delay)

This method simply calls Thread#sleep(long).

Parameter

Name	Description
delay	`org.threeten.bp.Duration` time to sleep

Exceptions

Type	Description
InterruptedException	if any thread has interrupted the current thread

submit(RetryingFuture<ResponseT> retryingFuture)

public ApiFuture<ResponseT> submit(RetryingFuture<ResponseT> retryingFuture)

Submits an attempt for execution in the current thread, causing the current thread to sleep for the specified by the RetryingFuture#getAttemptSettings() amount of time. As result, this method completes execution only after the specified retryingFuture completes.

Parameter

Name	Description
retryingFuture	`RetryingFuture<ResponseT>` the future previously returned by #createFuture(Callable, RetryingContext)

Returns

Type	Description
com.google.api.core.ApiFuture<ResponseT>	returns completed `retryingFuture`