com.arjuna.mwlabs.wst11.at.remote

Class UserTransactionStandaloneImple

java.lang.Object

com.arjuna.mw.wst11.UserTransaction

com.arjuna.mwlabs.wst11.at.remote.UserTransactionStandaloneImple

public class UserTransactionStandaloneImple
extends UserTransaction

An implementation of UserTransaction which employs an RPC MEP based completion protocol specific to JBoss to complete the transaction. This implementation allows the client to be deployed without the need to expose any service endpoints.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	_activationCoordinatorService
protected ContextManager	_ctxManager

Constructor Summary

Constructors

Constructor and Description
UserTransactionStandaloneImple()

Method Summary

Modifier and Type	Method and Description
void	begin() Start a new transaction.
void	begin(int timeout) Start a new transaction with the specified timeout as its lifetime.
void	beginSubordinate(int timeout) method provided for the benefit of UserSubordinateTransactionImple to allow it to begin a subordinate transaction which requires an existing context to be installed on the thread before it will start and instal la new transaction
void	commit() The transaction is committed by the commit method.
UserTransaction	getUserSubordinateTransaction() get the user subordinate transaction this is a UserTransaction whose begin method will create an interposed AT transaction
void	rollback() The rollback operation will terminate the transaction and return normally if it succeeded, while throwing an appropriate exception if it didn't.
protected Context	startTransaction(int timeout, TxContextImple current)
protected void	tidyup()
String	toString()
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, wait, wait, wait

Field Detail

_ctxManager

protected ContextManager _ctxManager

_activationCoordinatorService

protected String _activationCoordinatorService

Constructor Detail

UserTransactionStandaloneImple

public UserTransactionStandaloneImple()

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

Description copied from class: UserTransaction

Start a new transaction with the specified timeout as its lifetime. If one is already 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

Description copied from class: UserTransaction

The transaction is committed by the commit method. This will execute the PhaseZero, 2PC and OutcomeNotification protocols prior to returning. If there is no transaction associated with the invoking thread then WrongStateException is thrown. If the coordinator is not aware of the current transaction UnknownTransactionException is thrown. If the transaction ultimately rolls back then the TransactionRolledBackException is thrown. If any other error occurs a SystemException is thrown. When complete, this operation disassociates the transaction from the current thread such that it becomes associated with no transaction.

Specified by:

commit in class UserTransaction

Throws:

TransactionRolledBackException

UnknownTransactionException

SecurityException

SystemException

WrongStateException

rollback

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

Description copied from class: UserTransaction

The rollback operation will terminate the transaction and return normally if it succeeded, while throwing an appropriate exception if it didn't. If there is no transaction associated with the invoking thread then WrongStateException is thrown. If the coordinator is not aware of the current transaction UnknownTransactionException is thrown. If any other error occurs a SystemException is thrown. When complete, this operation disassociates the transaction from the current thread such that it becomes associated with no transaction.

Specified by:

rollback in class UserTransaction

Throws:

UnknownTransactionException

SecurityException

SystemException

WrongStateException

transactionIdentifier

public String transactionIdentifier()

Specified by:

transactionIdentifier in class UserTransaction

toString

public String toString()

Overrides:

toString in class Object

beginSubordinate

public void beginSubordinate(int timeout)
                      throws WrongStateException,
                             SystemException

method provided for the benefit of UserSubordinateTransactionImple to allow it to begin a subordinate transaction which requires an existing context to be installed on the thread before it will start and instal la new transaction

Parameters:

timeout -

Throws:

WrongStateException

SystemException

startTransaction

protected final Context startTransaction(int timeout,
                                         TxContextImple current)
                                  throws InvalidCreateParametersException,
                                         SystemException

Throws:

InvalidCreateParametersException

SystemException

tidyup

protected final void tidyup()