com.bigdata.rdf.sail.webapp.client

Class RemoteTransactionManager

java.lang.Object

com.bigdata.rdf.sail.webapp.client.RemoteTransactionManager

public class RemoteTransactionManager
extends Object

Remote client for the Transaction Management API.

Since:

1.5.2

Author:

bryan

See Also:

Support read/write transactions in the REST API

Field Summary

Fields

Modifier and Type	Field and Description
static long	READ_COMMITTED The constant that should be used to request a read-only transaction against the current commit point on the database at the time that the request is processed by the server.
static long	UNISOLATED The constant that SHOULD used to request a read/write transaction.

Constructor Summary

Constructors

Constructor and Description
RemoteTransactionManager(RemoteRepositoryManager remoteRepositoryManager) Flyweight constructor for stateless transaction manager client.

Method Summary

Methods

Modifier and Type	Method and Description
IRemoteTx	createTx(long timestamp) CREATE-TX: Create a transaction on the server.
static boolean	isReadWriteTx(long txId) Return true iff the transaction identifier would be associated with a read/write transaction.
Iterator<IRemoteTxState0>	listTx() LIST-TX: Return the set of active transactions.
IRemoteTxState0	statusTx(long txId) STATUS-TX: Return information about a transaction, including whether or not it is active.

Methods inherited from class java.lang.Object

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

Field Detail

UNISOLATED

public static final long UNISOLATED

The constant that SHOULD used to request a read/write transaction. The transaction will read on the current commit point on the database at the time that the request is processed by the server.

See Also:

Constant Field Values

READ_COMMITTED

public static final long READ_COMMITTED

The constant that should be used to request a read-only transaction against the current commit point on the database at the time that the request is processed by the server.

See Also:

Constant Field Values

Constructor Detail

RemoteTransactionManager

public RemoteTransactionManager(RemoteRepositoryManager remoteRepositoryManager)

Flyweight constructor for stateless transaction manager client.

Parameters:

remoteRepositoryManager -

Method Detail

isReadWriteTx

public static boolean isReadWriteTx(long txId)

Return true iff the transaction identifier would be associated with a read/write transaction. This is a purely syntactic check of the numerical value of the transaction identifier. Negative transaction identifiers are read/write transactions.

Parameters:

txId - The transaction identifier.

Returns:

true iff it is a read/write transaction.

createTx

public IRemoteTx createTx(long timestamp)

CREATE-TX: Create a transaction on the server.

UNISOLATED

his requests a new read/write transaction. The transaction will read on the last commit point on the database at the time that the transaction was created. This is the default behavior if the timestamp parameter is not specified. Note: The federation architecture (aka scale-out) does NOT support distributed read/write transactions - all mutations in scale-out are shard-wise ACID.

READ_COMMITTED

This requests a new read-only transaction. The transaction will read on the last commit point on the database at the time that the transaction was created.

A timestamp

This requests a new read-only transaction. The operation will be executed again the most recent committed state whose commit timestamp is less than or equal to timestamp.

Parameters:

timestamp - The timestamp used to indicate the type of transaction requested.

Returns:

The transaction object.

listTx

public Iterator<IRemoteTxState0> listTx()

LIST-TX: Return the set of active transactions.

statusTx

public IRemoteTxState0 statusTx(long txId)
                         throws RemoteTransactionNotFoundException

STATUS-TX: Return information about a transaction, including whether or not it is active.

Parameters:

txId - The transaction identifier.

Returns:

The IRemoteTx for that transaction.

Throws:

RemoteTransactionNotFoundException - if the transaction was not found on the server.

RemoteTransactionNotFoundException