org.jboss.jbossts.xts.recovery.participant.at

Class XTSATSubordinateRecoveryModule

java.lang.Object

org.jboss.jbossts.xts.recovery.participant.at.XTSATSubordinateRecoveryModule

All Implemented Interfaces:

XTSATRecoveryModule

public class XTSATSubordinateRecoveryModule
extends Object
implements XTSATRecoveryModule

A recovery module which recovers durable participants registered by subordinate coordinators

Constructor Summary

Constructors

Constructor and Description
XTSATSubordinateRecoveryModule()

Method Summary

Modifier and Type	Method and Description
Durable2PCParticipant	deserialize(String id, ObjectInputStream stream) called during recovery processing to allow an application to identify a participant id belonging to one of its participants and recreate the participant by deserializing it from the supplied object input stream.
void	endScan() we don't need to use this because the AT recovery manager tracks whether a subordinate AT scan has happened
Durable2PCParticipant	recreate(String id, byte[] recoveryState) called during recovery processing to allow an application to identify a participant id belonging to one of its participants and use the saved recovery state to recreate the participant.

Methods inherited from class java.lang.Object

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

Constructor Detail

XTSATSubordinateRecoveryModule

public XTSATSubordinateRecoveryModule()

Method Detail

deserialize

public Durable2PCParticipant deserialize(String id,
                                         ObjectInputStream stream)
                                  throws Exception

Description copied from interface: XTSATRecoveryModule

called during recovery processing to allow an application to identify a participant id belonging to one of its participants and recreate the participant by deserializing it from the supplied object input stream. n.b. this is only appropriate in case the participant was originally saved using serialization.

Specified by:

deserialize in interface XTSATRecoveryModule

Parameters:

id - the id used when the participant was created

stream - a stream from which the application should deserialise the participant if it recognises that the id belongs to the module's application

Returns:

the deserialized Durable2PCParticipant

Throws:

Exception - if an error occurs deserializing the durable participant

recreate

public Durable2PCParticipant recreate(String id,
                                      byte[] recoveryState)
                               throws Exception

Description copied from interface: XTSATRecoveryModule

called during recovery processing to allow an application to identify a participant id belonging to one of its participants and use the saved recovery state to recreate the participant. n.b. this is only appropriate in case the participant was originally saved after being converted to a byte array using the PersistibleATParticipant interface.

Specified by:

recreate in interface XTSATRecoveryModule

Parameters:

id - the id used when the participant was created

recoveryState - a byte array returned form the original participant via a call to method getRecoveryState of interface PersistableATParticipant

Returns:

the recreated Durable2PCParticipant

Throws:

Exception - if an error occurs converting the recoveryState back to a durable participant

endScan

public void endScan()

we don't need to use this because the AT recovery manager tracks whether a subordinate AT scan has happened

Specified by:

endScan in interface XTSATRecoveryModule