com.arjuna.ats.internal.jta.transaction.jts.subordinate

Class TransactionImple

java.lang.Object

com.arjuna.ats.internal.jta.transaction.jts.TransactionImple

com.arjuna.ats.internal.jta.transaction.jts.subordinate.TransactionImple

All Implemented Interfaces:

Transaction

Direct Known Subclasses:

TransactionImple

public class TransactionImple
extends TransactionImple

Field Summary

Fields inherited from class com.arjuna.ats.internal.jta.transaction.jts.TransactionImple

_theTransaction

Fields inherited from interface com.arjuna.ats.jta.transaction.Transaction

XACONNECTION, XAMODIFIER

Constructor Summary

Constructors

Constructor and Description
TransactionImple(AtomicTransaction imported) Create a new transaction with the specified timeout.

Method Summary

Modifier and Type	Method and Description
void	commit() This is a subordinate transaction, so any attempt to commit it or roll it back directly, should fail.
protected void	commitAndDisassociate()
boolean	doBeforeCompletion()
void	doCommit() Drive the subordinate transaction to commit.
void	doForget() Called to tell the transaction to forget any heuristics.
void	doOnePhaseCommit() Drive the transaction to commit.
int	doPrepare() Drive the subordinate transaction through the prepare phase.
void	doRollback() Drive the subordinate transaction to roll back.
boolean	equals(Object obj) Overloads Object.equals()
void	rollback() This is a subordinate transaction, so any attempt to commit it or roll it back directly, should fail.
protected void	rollbackAndDisassociate()
String	toString()

Methods inherited from class com.arjuna.ats.internal.jta.transaction.jts.TransactionImple

baseXid, delistResource, endSuspendedRMs, enlistResource, enlistResource, get_uid, getControlWrapper, getRemainingTimeoutMills, getResources, getStatus, getSynchronizations, getTimeout, getTransactions, getTxId, getTxLocalResource, getXAResourceState, hashCode, isAlive, putTransaction, putTxLocalResource, registerSynchronization, removeTransaction, setRollbackOnly, shutdown

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

TransactionImple

public TransactionImple(AtomicTransaction imported)

Create a new transaction with the specified timeout.

Method Detail

equals

public boolean equals(Object obj)

Overloads Object.equals()

Overrides:

equals in class TransactionImple

commit

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

This is a subordinate transaction, so any attempt to commit it or roll it back directly, should fail.

Specified by:

commit in interface Transaction

Overrides:

commit in class TransactionImple

Throws:

RollbackException

HeuristicMixedException

HeuristicRollbackException

SecurityException

SystemException

IllegalStateException

rollback

public void rollback()
              throws IllegalStateException,
                     SecurityException,
                     SystemException

This is a subordinate transaction, so any attempt to commit it or roll it back directly, should fail.

Specified by:

rollback in interface Transaction

Overrides:

rollback in class TransactionImple

Throws:

IllegalStateException

SecurityException

SystemException

doPrepare

public int doPrepare()

Drive the subordinate transaction through the prepare phase. Any enlisted participants will also be prepared as a result.

Returns:

a TwoPhaseOutcome representing the result.

Throws:

SystemException - thrown if any error occurs.

doCommit

public void doCommit()
              throws IllegalStateException,
                     HeuristicMixedException,
                     HeuristicRollbackException,
                     HeuristicCommitException,
                     SystemException

Drive the subordinate transaction to commit. It must have previously been prepared.

Throws:

IllegalStateException - thrown if the transaction has not been prepared or is unknown.

HeuristicMixedException - thrown if a heuristic mixed outcome occurs (where some participants committed whilst others rolled back).

HeuristicRollbackException - thrown if the transaction rolled back.

SystemException - thrown if some other error occurs.

HeuristicCommitException

doRollback

public void doRollback()
                throws IllegalStateException,
                       HeuristicMixedException,
                       HeuristicCommitException,
                       HeuristicRollbackException,
                       SystemException

Drive the subordinate transaction to roll back. It need not have been previously prepared.

Throws:

IllegalStateException - thrown if the transaction is not known by the system or has been previously terminated.

HeuristicMixedException - thrown if a heuristic mixed outcome occurs (can only happen if the transaction was previously prepared and then only if some participants commit whilst others roll back).

HeuristicCommitException - thrown if the transaction commits (can only happen if it was previously prepared).

SystemException - thrown if any other error occurs.

HeuristicRollbackException

doOnePhaseCommit

public void doOnePhaseCommit()
                      throws IllegalStateException,
                             RollbackException,
                             HeuristicMixedException,
                             SystemException

Drive the transaction to commit. It should not have been previously prepared and will be the only resource in the global transaction.

Throws:

IllegalStateException - if the transaction has already terminated

HeuristicRollbackException - thrown if the transaction rolls back.

RollbackException

HeuristicMixedException

SystemException

doForget

public void doForget()
              throws IllegalStateException

Called to tell the transaction to forget any heuristics.

Throws:

IllegalStateException - thrown if the transaction cannot be found.

doBeforeCompletion

public boolean doBeforeCompletion()
                           throws SystemException

Throws:

SystemException

toString

public String toString()

Overrides:

toString in class TransactionImple

commitAndDisassociate

protected void commitAndDisassociate()
                              throws RollbackException,
                                     HeuristicMixedException,
                                     HeuristicRollbackException,
                                     SecurityException,
                                     SystemException,
                                     IllegalStateException

Overrides:

commitAndDisassociate in class TransactionImple

Throws:

RollbackException

HeuristicMixedException

HeuristicRollbackException

SecurityException

SystemException

IllegalStateException

rollbackAndDisassociate

protected void rollbackAndDisassociate()
                                throws IllegalStateException,
                                       SecurityException,
                                       SystemException

Overrides:

rollbackAndDisassociate in class TransactionImple

Throws:

IllegalStateException

SecurityException

SystemException