com.arjuna.wst

Interface Participant

All Known Subinterfaces:

Durable2PCParticipant, Volatile2PCParticipant

All Known Implementing Classes:

BridgeDurableParticipant, BridgeVolatileParticipant, Durable2PCStub, ParticipantStub, SubordinateDurable2PCStub, SubordinateVolatile2PCStub, Volatile2PCStub

public interface Participant

The base Participant.

Method Summary

Modifier and Type	Method and Description
void	commit() The participant should make permanent the work that it controls.
void	error() During recovery the participant can enquire as to the status of the transaction it was registered with.
Vote	prepare() Perform any work necessary to allow it to either commit or rollback the work performed by the Web service under the scope of the transaction.
void	rollback() The participant should undo the work that it controls.
void	unknown() During recovery the participant can enquire as to the status of the transaction it was registered with.

Method Detail

prepare

Vote prepare()
      throws WrongStateException,
             SystemException

Perform any work necessary to allow it to either commit or rollback the work performed by the Web service under the scope of the transaction. The implementation is free to do whatever it needs to in order to fulfill the implicit contract between it and the coordinator.

Returns:

an indication of whether it can prepare or not.

Throws:

WrongStateException

SystemException

See Also:

Vote

commit

void commit()
     throws WrongStateException,
            SystemException

The participant should make permanent the work that it controls.

Throws:

WrongStateException

SystemException

rollback

void rollback()
       throws WrongStateException,
              SystemException

The participant should undo the work that it controls. The participant will then return an indication of whether or not it succeeded.

Throws:

WrongStateException

SystemException

unknown

void unknown()
      throws SystemException

During recovery the participant can enquire as to the status of the transaction it was registered with. If that transaction is no longer available (has rolled back) then this operation will be invoked by the coordination service.

Throws:

SystemException

error

void error()
    throws SystemException

During recovery the participant can enquire as to the status of the transaction it was registered with. If an error occurs (e.g., the transaction service is unavailable) then this operation will be invoked.

Throws:

SystemException