|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectcom.arjuna.wst.stub.LocalParticipantCompletionParticipantStub
public class LocalParticipantCompletionParticipantStub
wrapper class allowing an application participant to be registered directly with the local coordinator service. obvioulsy this wrapper cuts out the network hop delivering messgaes from coordinator to participant and vice versa. it also differs from the remote stub in two further respects. firstly, it saves and restores the participant details embedded directly in the coordinator (transaction) log record rather than in a separate participant record. this still requires use of an application registered helper module to recreate the participant from its saved state. secondly, it does not currently propagate the participant manager details to the underlying participant.
Field Summary | |
---|---|
protected java.lang.String |
id
|
protected BusinessAgreementWithParticipantCompletionParticipant |
participant
|
Constructor Summary | |
---|---|
LocalParticipantCompletionParticipantStub()
|
|
LocalParticipantCompletionParticipantStub(BusinessAgreementWithParticipantCompletionParticipant participant,
java.lang.String id)
|
Method Summary | |
---|---|
void |
cancel()
The transaction has cancelled, and the participant should undo any work. |
void |
close()
The transaction has completed successfully. |
void |
compensate()
The transaction has cancelled. |
void |
error()
If the participant enquired as to the status of the transaction it was registered with and an error occurs (e.g., the transaction service is unavailable) then this operation will be invoked. |
boolean |
restoreState(com.arjuna.ats.arjuna.state.InputObjectState ios)
Restore the state of the particpant from the specified input object stream. |
boolean |
saveState(com.arjuna.ats.arjuna.state.OutputObjectState oos)
Save the state of the particpant to the specified input object stream. |
java.lang.String |
status()
|
void |
unknown()
If the participant enquires as to the status of the transaction it was registered with and that transaction is no longer available (has rolled back) then this operation will be invoked by the coordination service. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
protected BusinessAgreementWithParticipantCompletionParticipant participant
protected java.lang.String id
Constructor Detail |
---|
public LocalParticipantCompletionParticipantStub(BusinessAgreementWithParticipantCompletionParticipant participant, java.lang.String id)
public LocalParticipantCompletionParticipantStub()
Method Detail |
---|
public void close() throws WrongStateException, SystemException
close
in interface BusinessAgreementWithParticipantCompletionParticipant
WrongStateException
SystemException
public void cancel() throws FaultedException, WrongStateException, SystemException
cancel
in interface BusinessAgreementWithParticipantCompletionParticipant
FaultedException
WrongStateException
SystemException
public void compensate() throws FaultedException, WrongStateException, SystemException
compensate
in interface BusinessAgreementWithParticipantCompletionParticipant
FaultedException
- if the participant was unable to
perform the required compensation action because of an
unrecoverable error. The coordinator is notified of this fault
and as a result will stop resending compensation requests.
SystemException
- if the participant was unable to
perform the required compensation action because of a transient
fault. The coordinator is not notified of this fault so it
will retry the compensate request after a suitable timeout.
WrongStateException
public java.lang.String status() throws SystemException
status
in interface BusinessAgreementWithParticipantCompletionParticipant
SystemException
public void unknown() throws SystemException
unknown
in interface BusinessAgreementWithParticipantCompletionParticipant
SystemException
public void error() throws SystemException
error
in interface BusinessAgreementWithParticipantCompletionParticipant
SystemException
public boolean saveState(com.arjuna.ats.arjuna.state.OutputObjectState oos)
saveState
in interface PersistableParticipant
oos
- The output output stream.
public boolean restoreState(com.arjuna.ats.arjuna.state.InputObjectState ios)
restoreState
in interface PersistableParticipant
ios
- The Input object stream.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |