com.scalar.db.transaction.rpc

Class GrpcTransactionManager

java.lang.Object

com.scalar.db.transaction.common.AbstractDistributedTransactionManager

com.scalar.db.transaction.rpc.GrpcTransactionManager

All Implemented Interfaces:

DistributedTransactionManager

@ThreadSafe
public class GrpcTransactionManager
extends AbstractDistributedTransactionManager

Constructor Summary

Constructors

Constructor and Description
GrpcTransactionManager(DatabaseConfig databaseConfig)

Method Summary

Modifier and Type	Method and Description
TransactionState	abort(java.lang.String txId) Aborts a given transaction.
void	close() Closes connections to the cluster.
TransactionState	getState(java.lang.String txId) Returns the state of a given transaction.
GrpcTransaction	start() Starts a new transaction.
GrpcTransaction	start(Isolation isolation) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.
GrpcTransaction	start(Isolation isolation, SerializableStrategy strategy) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.
GrpcTransaction	start(SerializableStrategy strategy) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.
GrpcTransaction	start(java.lang.String txId) Starts a new transaction with the specified transaction ID.
GrpcTransaction	start(java.lang.String txId, Isolation isolation) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.
GrpcTransaction	start(java.lang.String txId, Isolation isolation, SerializableStrategy strategy) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.
GrpcTransaction	start(java.lang.String txId, SerializableStrategy strategy) Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Methods inherited from class com.scalar.db.transaction.common.AbstractDistributedTransactionManager

getNamespace, getTable, with, withNamespace, withTable

Methods inherited from class java.lang.Object

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

Constructor Detail

GrpcTransactionManager

@Inject
public GrpcTransactionManager(DatabaseConfig databaseConfig)

Method Detail

start

public GrpcTransaction start()
                      throws TransactionException

Description copied from interface: DistributedTransactionManager

Starts a new transaction.

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

public GrpcTransaction start(java.lang.String txId)
                      throws TransactionException

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified transaction ID. It is users' responsibility to guarantee uniqueness of the ID so it is not recommended to use this method unless you know exactly what you are doing.

Parameters:

txId - an user-provided unique transaction ID

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(Isolation isolation)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified Isolation level.

Parameters:

isolation - an isolation level

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(java.lang.String txId,
                                         Isolation isolation)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified transaction ID and Isolation level. It is users' responsibility to guarantee uniqueness of the ID so it is not recommended to use this method unless you know exactly what you are doing.

Parameters:

txId - an user-provided unique transaction ID

isolation - an isolation level

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(Isolation isolation,
                                         SerializableStrategy strategy)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified Isolation level and SerializableStrategy. If the isolation is not SERIALIZABLE, the serializable strategy is ignored.

Parameters:

isolation - an isolation level

strategy - a serializable strategy

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(SerializableStrategy strategy)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with Serializable isolation level and the specified SerializableStrategy.

Parameters:

strategy - a serializable strategy

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(java.lang.String txId,
                                         SerializableStrategy strategy)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified transaction ID, Serializable isolation level and the specified SerializableStrategy. It is users' responsibility to guarantee uniqueness of the ID so it is not recommended to use this method unless you know exactly what you are doing.

Parameters:

txId - an user-provided unique transaction ID

strategy - a serializable strategy

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

start

@Deprecated
public GrpcTransaction start(java.lang.String txId,
                                         Isolation isolation,
                                         SerializableStrategy strategy)
                                  throws TransactionException

Deprecated. As of release 2.4.0. Will be removed in release 4.0.0.

Description copied from interface: DistributedTransactionManager

Starts a new transaction with the specified transaction ID, Isolation level and SerializableStrategy. It is users' responsibility to guarantee uniqueness of the ID so it is not recommended to use this method unless you know exactly what you are doing. If the isolation is not SERIALIZABLE, the serializable strategy is ignored.

Parameters:

txId - an user-provided unique transaction ID

isolation - an isolation level

strategy - a serializable strategy

Returns:

DistributedTransaction

Throws:

TransactionException - if starting the transaction failed

getState

public TransactionState getState(java.lang.String txId)
                          throws TransactionException

Description copied from interface: DistributedTransactionManager

Returns the state of a given transaction.

Parameters:

txId - a transaction ID

Returns:

TransactionState

Throws:

TransactionException - if getting the state of a given transaction failed

abort

public TransactionState abort(java.lang.String txId)
                       throws TransactionException

Description copied from interface: DistributedTransactionManager

Aborts a given transaction.

Parameters:

txId - a transaction ID

Returns:

TransactionState

Throws:

TransactionException - if aborting the given transaction failed

close

public void close()

Description copied from interface: DistributedTransactionManager

Closes connections to the cluster. The connections are shared among multiple services such as StorageService and TransactionService, thus this should only be used when closing applications.