com.google.cloud.bigtable.grpc.async

Class AbstractRetryingOperation<RequestT,ResponseT,ResultT>

java.lang.Object

io.grpc.ClientCall.Listener<ResponseT>

com.google.cloud.bigtable.grpc.async.AbstractRetryingOperation<RequestT,ResponseT,ResultT>

Direct Known Subclasses:

RetryingMutateRowsOperation, RetryingReadRowsOperation, RetryingStreamOperation, RetryingUnaryOperation

public abstract class AbstractRetryingOperation<RequestT,ResponseT,ResultT>
extends io.grpc.ClientCall.Listener<ResponseT>

A ClientCall.Listener that retries a BigtableAsyncRpc request.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractRetryingOperation.GrpcFuture<RespT>

Field Summary

Fields

Modifier and Type	Field and Description
protected io.grpc.ClientCall<RequestT,ResponseT>	call
protected Object	callLock
protected AbstractRetryingOperation.GrpcFuture<ResultT>	completionFuture
protected com.google.api.client.util.BackOff	currentBackoff
protected int	failedCount
protected static Logger	LOG Constant LOG
protected io.opencensus.trace.Span	operationSpan
protected Timer.Context	operationTimerContext
protected ScheduledExecutorService	retryExecutorService
protected RetryOptions	retryOptions
protected BigtableAsyncRpc<RequestT,ResponseT>	rpc
protected Timer.Context	rpcTimerContext
protected static long	UNARY_DEADLINE_MINUTES

Constructor Summary

Constructors

Constructor and Description
AbstractRetryingOperation(RetryOptions retryOptions, RequestT request, BigtableAsyncRpc<RequestT,ResponseT> retryableRpc, io.grpc.CallOptions callOptions, ScheduledExecutorService retryExecutorService, io.grpc.Metadata originalMetadata) Constructor for AbstractRetryingRpcListener.

Method Summary

Modifier and Type	Method and Description
void	cancel() Cancels the RPC.
protected void	cancel(String message) Cancels the RPC with a specific message.
protected void	finalizeStats(io.grpc.Status status)
com.google.common.util.concurrent.ListenableFuture<ResultT>	getAsyncResult() Initial execution of the RPC.
ResultT	getBlockingResult()
protected io.grpc.CallOptions	getCallOptions()
protected BigtableRetriesExhaustedException	getExhaustedRetriesException(io.grpc.Status status)
protected long	getNextBackoff()
RequestT	getOriginalRequest()
protected RequestT	getRetryRequest()
protected Runnable	getRunnable()
protected boolean	isRequestRetryable()
void	onClose(io.grpc.Status status, io.grpc.Metadata trailers)
protected void	onError(io.grpc.Status status, io.grpc.Metadata trailers)
protected abstract boolean	onOK(io.grpc.Metadata trailers) A subclass has the opportunity to perform the final operations it needs now that the RPC is successfully complete.
protected void	performRetry(long nextBackOff)
protected void	run() Calls BigtableAsyncRpc.newCall(CallOptions) and BigtableAsyncRpc.start(Object, io.grpc.ClientCall.Listener, Metadata, ClientCall) } with this as the listener so that retries happen correctly.
protected void	setException(Exception exception)

Methods inherited from class io.grpc.ClientCall.Listener

onHeaders, onMessage, onReady

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected static final Logger LOG

Constant LOG

UNARY_DEADLINE_MINUTES

protected static final long UNARY_DEADLINE_MINUTES

See Also:

Constant Field Values

currentBackoff

protected com.google.api.client.util.BackOff currentBackoff

rpc

protected final BigtableAsyncRpc<RequestT,ResponseT> rpc

retryOptions

protected final RetryOptions retryOptions

retryExecutorService

protected final ScheduledExecutorService retryExecutorService

failedCount

protected int failedCount

completionFuture

protected final AbstractRetryingOperation.GrpcFuture<ResultT> completionFuture

callLock

protected Object callLock

call

protected io.grpc.ClientCall<RequestT,ResponseT> call

operationTimerContext

protected Timer.Context operationTimerContext

rpcTimerContext

protected Timer.Context rpcTimerContext

operationSpan

protected final io.opencensus.trace.Span operationSpan

Constructor Detail

AbstractRetryingOperation

public AbstractRetryingOperation(RetryOptions retryOptions,
                                 RequestT request,
                                 BigtableAsyncRpc<RequestT,ResponseT> retryableRpc,
                                 io.grpc.CallOptions callOptions,
                                 ScheduledExecutorService retryExecutorService,
                                 io.grpc.Metadata originalMetadata)

Constructor for AbstractRetryingRpcListener.

Parameters:

retryOptions - a RetryOptions object.

request - a RequestT object.

retryableRpc - a BigtableAsyncRpc object.

callOptions - a CallOptions object.

retryExecutorService - a ScheduledExecutorService object.

originalMetadata - a Metadata object.

Method Detail

onClose

public void onClose(io.grpc.Status status,
                    io.grpc.Metadata trailers)

Overrides:

onClose in class io.grpc.ClientCall.Listener<ResponseT>

finalizeStats

protected void finalizeStats(io.grpc.Status status)

onError

protected void onError(io.grpc.Status status,
                       io.grpc.Metadata trailers)

getExhaustedRetriesException

protected BigtableRetriesExhaustedException getExhaustedRetriesException(io.grpc.Status status)

performRetry

protected void performRetry(long nextBackOff)

getRunnable

protected Runnable getRunnable()

isRequestRetryable

protected boolean isRequestRetryable()

setException

protected void setException(Exception exception)

onOK

protected abstract boolean onOK(io.grpc.Metadata trailers)

A subclass has the opportunity to perform the final operations it needs now that the RPC is successfully complete. If a subclass has to retry, due to the message, this method will return false

Returns:

true if the operation was really completed.

getNextBackoff

protected long getNextBackoff()

run

protected void run()

Calls BigtableAsyncRpc.newCall(CallOptions) and BigtableAsyncRpc.start(Object, io.grpc.ClientCall.Listener, Metadata, ClientCall) } with this as the listener so that retries happen correctly.

getCallOptions

protected io.grpc.CallOptions getCallOptions()

getRetryRequest

protected RequestT getRetryRequest()

getOriginalRequest

public final RequestT getOriginalRequest()

getAsyncResult

public com.google.common.util.concurrent.ListenableFuture<ResultT> getAsyncResult()

Initial execution of the RPC.

cancel

public void cancel()

Cancels the RPC.

getBlockingResult

public ResultT getBlockingResult()

cancel

protected void cancel(String message)

Cancels the RPC with a specific message.

Parameters:

message -