com.bigdata.rdf.sail.webapp.client

Interface IRemoteTx

All Superinterfaces:

IRemoteTxState0

public interface IRemoteTx
extends IRemoteTxState0

Interface for blazegraph transactions on the client.

Author:

bryan

See Also:

Support read/write transactions in the REST API

Method Summary

Methods

Modifier and Type	Method and Description
void	abort() Aborts a read/write transaction (discarding its write set) -or- deactivates a read-only transaction.
void	commit() Prepares and commits a read/write transaction -or- deactivates a read-only transaction.
boolean	isActive() Return true iff the client believes that transaction is active (it exists and has not been aborted nor committed).
boolean	prepare() Return true if the write set of the transaction passes validation at the time that the server processes this request.

Methods inherited from interface com.bigdata.rdf.sail.webapp.client.IRemoteTxState0

getReadsOnCommitTime, getTxId, isReadOnly

Method Detail

isActive

boolean isActive()

Return true iff the client believes that transaction is active (it exists and has not been aborted nor committed). Note that the transaction may have been aborted on the server, in which case the client will not know this until it tries to prepare(), abort(), or commit().

prepare

boolean prepare()
                throws RemoteTransactionNotFoundException

Return true if the write set of the transaction passes validation at the time that the server processes this request. If a transaction fails validation then commit() will fail for that transaction. If it passes validation, then commit() is not known to fail at this time.

Note: transactions always validate during commit(). Invoking this method explicitly is discouraged since it just adds overhead unless you are actually going to gain something from the information.

Throws:

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

RemoteTransactionNotFoundException

abort

void abort()
           throws RemoteTransactionNotFoundException

Aborts a read/write transaction (discarding its write set) -or- deactivates a read-only transaction.

Note: You MUST always either abort() or commit() a read-only transaction in order to release the resources on the server!

Throws:

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

RemoteTransactionNotFoundException

commit

void commit()
            throws RemoteTransactionNotFoundException

Prepares and commits a read/write transaction -or- deactivates a read-only transaction.

Note: You MUST always either abort() or commit() a read-only transaction in order to release the resources on the server!

Throws:

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

RemoteTransactionValidationException - if the transaction exists but could not be validated.

RemoteTransactionNotFoundException