com.google.api.gax.retrying

Class DirectRetryingExecutor<ResponseT>

java.lang.Object

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

Type Parameters:

ResponseT - response type

All Implemented Interfaces:

RetryingExecutor<ResponseT>

@BetaApi
public class DirectRetryingExecutor<ResponseT>
extends Object
implements RetryingExecutor<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.

Constructor Summary

Constructors

Constructor and Description
DirectRetryingExecutor(RetryAlgorithm<ResponseT> retryAlgorithm) Creates a new direct retrying executor instance, which will be using retryAlgorithm to determine retrying strategy.

Method Summary

Modifier and Type	Method and Description
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.
com.google.api.core.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.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DirectRetryingExecutor

public DirectRetryingExecutor(RetryAlgorithm<ResponseT> retryAlgorithm)

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

Parameters:

retryAlgorithm - retry algorithm to use for attempts execution

Throws:

NullPointerException - if retryAlgorithm is null

Method Detail

createFuture

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.

Specified by:

createFuture in interface RetryingExecutor<ResponseT>

Parameters:

callable - the actual callable, which should be executed in a retriable context

Returns:

retrying future facade

submit

public com.google.api.core.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.

Specified by:

submit in interface RetryingExecutor<ResponseT>

Parameters:

retryingFuture - the future previously returned by createFuture(Callable)

Returns:

returns completed retryingFuture