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>, RetryingExecutorWithContext<ResponseT>

public class DirectRetryingExecutor<ResponseT>
extends Object
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.

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.
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.
protected void	sleep(org.threeten.bp.Duration delay) This method simply calls Thread.sleep(long).
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

createFuture

@BetaApi(value="The surface for passing per operation state is not yet stable")
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.

Specified by:

createFuture in interface RetryingExecutorWithContext<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, RetryingContext)

Returns:

returns completed retryingFuture

sleep

protected void sleep(org.threeten.bp.Duration delay)
              throws InterruptedException

This method simply calls Thread.sleep(long).

Parameters:

delay - time to sleep

Throws:

InterruptedException - if any thread has interrupted the current thread