com.arjuna.mwlabs.wst11.at.remote

Class UserSubordinateTransactionImple

java.lang.Object

com.arjuna.mw.wst11.UserTransaction

com.arjuna.mwlabs.wst11.at.remote.UserSubordinateTransactionImple

public class UserSubordinateTransactionImple
extends UserTransaction

Implementation of class used to create a subordinate AT transaction This class normally redirects all calls to call the corresponding method of the singleton instance which implements UserTransaction. In the case of a begin call it redirects to a beginSubordinate call on the UserTransaction singleton. In the case of a commit or rollback it throws a WrongStateException, irrespective of whether the current transaction is top-level or subordinate since these operations should only be attempted via the UserTransactionImple singleton obtained by calling TransactionFactory.userTransaction()

Constructor Summary

Constructors

Constructor and Description
UserSubordinateTransactionImple()

Method Summary

Modifier and Type	Method and Description
void	begin() Start a new transaction.
void	begin(int timeout) Start a new subordinate transaction with the specified timeout as its lifetime.
void	commit() it is inappropriate to call this even if the current transaction is a top level AT transaction so we always throw a WrongStateException.
UserTransaction	getUserSubordinateTransaction() get the user subordinate transaction this is a UserTransaction whose begin method will create an interposed AT transaction
void	rollback() it is inappropriate to call this even if the current transaction is a top level AT transaction so we always throw a WrongStateException.
String	transactionIdentifier()

Methods inherited from class com.arjuna.mw.wst11.UserTransaction

getUserTransaction, setUserTransaction

Methods inherited from class java.lang.Object

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

Constructor Detail

UserSubordinateTransactionImple

public UserSubordinateTransactionImple()

Method Detail

getUserSubordinateTransaction

public UserTransaction getUserSubordinateTransaction()

Description copied from class: UserTransaction

get the user subordinate transaction this is a UserTransaction whose begin method will create an interposed AT transaction

Specified by:

getUserSubordinateTransaction in class UserTransaction

begin

public void begin()
           throws WrongStateException,
                  SystemException

Description copied from class: UserTransaction

Start a new transaction. If one is already associated with this thread then the WrongStateException will be thrown. Upon success, this operation associates the newly created transaction with the current thread.

Specified by:

begin in class UserTransaction

Throws:

WrongStateException

SystemException

begin

public void begin(int timeout)
           throws WrongStateException,
                  SystemException

Start a new subordinate transaction with the specified timeout as its lifetime. If an AT transaction is not currently associated with this thread then the WrongStateException will be thrown.

Specified by:

begin in class UserTransaction

Throws:

WrongStateException

SystemException

commit

public void commit()
            throws TransactionRolledBackException,
                   UnknownTransactionException,
                   SecurityException,
                   SystemException,
                   WrongStateException

it is inappropriate to call this even if the current transaction is a top level AT transaction so we always throw a WrongStateException.

Specified by:

commit in class UserTransaction

Throws:

TransactionRolledBackException

UnknownTransactionException

SecurityException

SystemException

WrongStateException

rollback

public void rollback()
              throws UnknownTransactionException,
                     SecurityException,
                     SystemException,
                     WrongStateException

it is inappropriate to call this even if the current transaction is a top level AT transaction so we always throw a WrongStateException.

Specified by:

rollback in class UserTransaction

Throws:

UnknownTransactionException

SecurityException

SystemException

WrongStateException

transactionIdentifier

public String transactionIdentifier()

Specified by:

transactionIdentifier in class UserTransaction