org.modeshape.jcr.txn

Interface Transactions.Transaction

All Known Implementing Classes:

Transactions.BaseTransaction, Transactions.NestableThreadLocalTransaction, Transactions.RollbackOnlyTransaction, Transactions.SimpleTransaction, Transactions.SynchronizedTransaction, Transactions.TraceableSimpleTransaction

Enclosing class:

Transactions

public static interface Transactions.Transaction

The representation of a ModeShape fine-grained transaction for use when saving the changes made to a Session. Note that this transaction may wrap a newly-created transaction for the current thread, or it may wrap an existing and on-going transaction for the current thread. In either case, the caller still commits or rollsback the transaction as normal when it's work is done.

Method Summary

Modifier and Type	Method and Description
void	commit() Commit the transaction currently associated with the calling thread.
String	id() Returns a unique identifier for the transaction.
void	rollback() Rolls back the transaction currently associated with the calling thread.
int	status() Returns the status associated with the current transaction
void	uponCommit(Transactions.TransactionFunction function) Register a function that will be called after the current transaction has been committed successfully, or immediately if there is not currently an active transaction.
void	uponCompletion(Transactions.TransactionFunction function) Register a function that will be called when the current transaction completes.

Method Detail

id

String id()

Returns a unique identifier for the transaction.

Returns:

a String, never null

status

int status()
    throws SystemException

Returns the status associated with the current transaction

Returns:

an int code representing a transaction status.

Throws:

SystemException - - If the transaction service fails in an unexpected way.

See Also:

Status

uponCompletion

void uponCompletion(Transactions.TransactionFunction function)

Register a function that will be called when the current transaction completes. The function will be executed regardless whether the transaction was committed or rolled back and regardless if the commit or rollback call failed or not.

Parameters:

function - the completion function

uponCommit

void uponCommit(Transactions.TransactionFunction function)

Register a function that will be called after the current transaction has been committed successfully, or immediately if there is not currently an active transaction. If the transaction is rolled back, this function will not be executed.

Parameters:

function - the completion function

commit

void commit()
     throws RollbackException,
            HeuristicMixedException,
            HeuristicRollbackException,
            SecurityException,
            IllegalStateException,
            SystemException

Commit the transaction currently associated with the calling thread.

Throws:

RollbackException - If the transaction was marked for rollback only, the transaction is rolled back and this exception is thrown.

IllegalStateException - If the calling thread is not associated with a transaction.

SystemException - If the transaction service fails in an unexpected way.

HeuristicMixedException - If a heuristic decision was made and some some parts of the transaction have been committed while other parts have been rolled back.

HeuristicRollbackException - If a heuristic decision to roll back the transaction was made.

SecurityException - If the caller is not allowed to commit this transaction.

rollback

void rollback()
       throws IllegalStateException,
              SecurityException,
              SystemException

Rolls back the transaction currently associated with the calling thread.

Throws:

IllegalStateException - If the transaction is in a state where it cannot be rolled back. This could be because the calling thread is not associated with a transaction, or because it is in the prepared state.

SecurityException - If the caller is not allowed to roll back this transaction.

SystemException - If the transaction service fails in an unexpected way.