com.arjuna.mwlabs.wst11.ba.remote

Class UserBusinessActivityImple

java.lang.Object

com.arjuna.mw.wst11.UserBusinessActivity

com.arjuna.mwlabs.wst11.ba.remote.UserBusinessActivityImple

public class UserBusinessActivityImple
extends UserBusinessActivity

This is the interface that allows transactions to be started and terminated. The messaging layer converts the Commit, Rollback and Notify messages into calls on this.

Field Summary

Fields inherited from class com.arjuna.mw.wst11.UserBusinessActivity

ATOMIC_OUTCOME, MIXED_OUTCOME

Constructor Summary

Constructors

Constructor and Description
UserBusinessActivityImple()

Method Summary

Modifier and Type	Method and Description
void	begin() Start a new business activity with atomic outcome.
void	begin(int timeout) Start a new BA with atomic outcome and the specified timeout as its lifetime.
void	beginSubordinate(int timeout)
void	cancel() If the BA must undo its work then the cancel method is used.
void	close() The BA is normally terminated by the close method.
void	complete() If participants have registered for the BusinessAgreementWithComplete protocol then they will be expecting the application to inform them when all work intended for them has been sent (and responded to).
UserBusinessActivity	getUserSubordinateBusinessActivity() get the user subordinate business activity this is a UserBusinessActivity whose begin method will create an interposed BA transaction
String	toString()
String	transactionIdentifier()

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

getUserBusinessActivity, setUserBusinessActivity

Methods inherited from class java.lang.Object

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

Constructor Detail

UserBusinessActivityImple

public UserBusinessActivityImple()

Method Detail

getUserSubordinateBusinessActivity

public UserBusinessActivity getUserSubordinateBusinessActivity()

Description copied from class: UserBusinessActivity

get the user subordinate business activity this is a UserBusinessActivity whose begin method will create an interposed BA transaction

Specified by:

getUserSubordinateBusinessActivity in class UserBusinessActivity

Returns:

The user business activity.

begin

public void begin()
           throws WrongStateException,
                  SystemException

Description copied from class: UserBusinessActivity

Start a new business activity with atomic outcome. 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 UserBusinessActivity

Throws:

WrongStateException

SystemException

begin

public void begin(int timeout)
           throws WrongStateException,
                  SystemException

Description copied from class: UserBusinessActivity

Start a new BA with atomic outcome and 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 UserBusinessActivity

Throws:

WrongStateException

SystemException

close

public void close()
           throws TransactionRolledBackException,
                  UnknownTransactionException,
                  SystemException,
                  WrongStateException

Description copied from class: UserBusinessActivity

The BA is normally terminated by the close method. This signals to all registered participants that the BA has ended and no compensation is required.

Specified by:

close in class UserBusinessActivity

Throws:

TransactionRolledBackException

UnknownTransactionException

SystemException

WrongStateException

cancel

public void cancel()
            throws UnknownTransactionException,
                   SystemException,
                   WrongStateException

Description copied from class: UserBusinessActivity

If the BA must undo its work then the cancel method is used. Any participants that can compensate are forced to do so.

Specified by:

cancel in class UserBusinessActivity

Throws:

UnknownTransactionException

SystemException

WrongStateException

complete

public void complete()
              throws UnknownTransactionException,
                     SystemException,
                     WrongStateException

Description copied from class: UserBusinessActivity

If participants have registered for the BusinessAgreementWithComplete protocol then they will be expecting the application to inform them when all work intended for them has been sent (and responded to). The complete method is used for this purpose.

Specified by:

complete in class UserBusinessActivity

Throws:

UnknownTransactionException

SystemException

WrongStateException

transactionIdentifier

public String transactionIdentifier()

Specified by:

transactionIdentifier in class UserBusinessActivity

toString

public String toString()

Overrides:

toString in class Object

beginSubordinate

public void beginSubordinate(int timeout)
                      throws WrongStateException,
                             SystemException

Throws:

WrongStateException

SystemException