Package com.google.cloud.spanner

Class DelayedAsyncTransactionManager

java.lang.Object

com.google.cloud.spanner.DelayedAsyncTransactionManager

All Implemented Interfaces:

AsyncTransactionManager, AutoCloseable

public class DelayedAsyncTransactionManager
extends Object
implements AsyncTransactionManager

Represents a AsyncTransactionManager using a multiplexed session that is not yet ready. The execution will be delayed until the multiplexed session has been created and is ready. This class is only used during the startup of the client and the multiplexed session has not yet been created.

Nested Class Summary

Nested classes/interfaces inherited from interface com.google.cloud.spanner.AsyncTransactionManager

AsyncTransactionManager.AsyncTransactionFunction<I,O>, AsyncTransactionManager.AsyncTransactionStep<I,O>, AsyncTransactionManager.CommitTimestampFuture, AsyncTransactionManager.TransactionContextFuture

Method Summary

Modifier and Type	Method	Description
AsyncTransactionManager.TransactionContextFuture	beginAsync()	Creates a new read write transaction.
AsyncTransactionManager.TransactionContextFuture	beginAsync(AbortedException exception)	Initializes a new read-write transaction that is a retry of a previously aborted transaction.
void	close()	Closes the manager.
com.google.api.core.ApiFuture<Void>	closeAsync()	Closes the transaction manager.
com.google.api.core.ApiFuture<CommitResponse>	getCommitResponse()	Returns the CommitResponse of this transaction.
TransactionManager.TransactionState	getState()	Returns the state of the transaction.
AsyncTransactionManager.TransactionContextFuture	resetForRetryAsync()	Creates a new transaction for retry.
com.google.api.core.ApiFuture<Void>	rollbackAsync()	Rolls back the currently active transaction.

Methods inherited from class java.lang.Object

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

Method Details

beginAsync

public AsyncTransactionManager.TransactionContextFuture beginAsync()

Description copied from interface: AsyncTransactionManager

Creates a new read write transaction. This must be called before doing any other operation and can only be called once. To create a new transaction for subsequent retries, see AsyncTransactionManager.resetForRetryAsync().

Specified by:

beginAsync in interface AsyncTransactionManager

beginAsync

public AsyncTransactionManager.TransactionContextFuture beginAsync(AbortedException exception)

Description copied from interface: AsyncTransactionManager

Initializes a new read-write transaction that is a retry of a previously aborted transaction. This method must be called before performing any operations, and it can only be invoked once per transaction lifecycle.

This method should only be used when multiplexed sessions are enabled to create a retry for a previously aborted transaction. This method can be used instead of AsyncTransactionManager.resetForRetryAsync() to create a retry. Using this method or AsyncTransactionManager.resetForRetryAsync() will have the same effect. You must pass in the AbortedException from the previous attempt to preserve the transaction's priority.

For regular sessions, this behaves the same as AsyncTransactionManager.beginAsync().

Specified by:

beginAsync in interface AsyncTransactionManager

rollbackAsync

public com.google.api.core.ApiFuture<Void> rollbackAsync()

Description copied from interface: AsyncTransactionManager

Rolls back the currently active transaction. In most cases there should be no need to call this explicitly since AsyncTransactionManager.close() would automatically roll back any active transaction.

Specified by:

rollbackAsync in interface AsyncTransactionManager

resetForRetryAsync

public AsyncTransactionManager.TransactionContextFuture resetForRetryAsync()

Description copied from interface: AsyncTransactionManager

Creates a new transaction for retry. This should only be called if the previous transaction failed with ABORTED. In all other cases, this will throw an IllegalStateException. Users should backoff before calling this method. Backoff delay is specified by SpannerException.getRetryDelayInMillis() on the SpannerException throw by the previous commit call.

Specified by:

resetForRetryAsync in interface AsyncTransactionManager

getState

public TransactionManager.TransactionState getState()

Description copied from interface: AsyncTransactionManager

Returns the state of the transaction.

Specified by:

getState in interface AsyncTransactionManager

getCommitResponse

public com.google.api.core.ApiFuture<CommitResponse> getCommitResponse()

Description copied from interface: AsyncTransactionManager

Returns the CommitResponse of this transaction.

Specified by:

getCommitResponse in interface AsyncTransactionManager

close

public void close()

Description copied from interface: AsyncTransactionManager

Closes the manager. If there is an active transaction, it will be rolled back. Underlying session will be released back to the session pool.

Specified by:

close in interface AsyncTransactionManager

Specified by:

close in interface AutoCloseable

closeAsync

public com.google.api.core.ApiFuture<Void> closeAsync()

Description copied from interface: AsyncTransactionManager

Closes the transaction manager. If there is an active transaction, it will be rolled back. The underlying session will be released back to the session pool. The returned ApiFuture is done when the transaction (if any) has been rolled back.

Specified by:

closeAsync in interface AsyncTransactionManager