com.arjuna.ats.internal.jts.orbspecific.recovery.recoverycoordinators

Class GenericRecoveryCoordinator

java.lang.Object

org.omg.PortableServer.Servant

org.omg.CosTransactions.RecoveryCoordinatorPOA

com.arjuna.ats.internal.jts.orbspecific.recovery.recoverycoordinators.GenericRecoveryCoordinator

All Implemented Interfaces:

InvokeHandler, RecoveryCoordinatorOperations

Direct Known Subclasses:

JacOrbRCDefaultServant, JavaIdlRCDefaultServant

public class GenericRecoveryCoordinator
extends RecoveryCoordinatorPOA

This provides the ORB-independent recovery coordinator functionality. The ORB-specific implementations delegate their work to this.

Version:

$Id: GenericRecoveryCoordinator.java 2342 2006-03-30 13:06:17Z $

Author:

Dave Ingham(dave.ingham@arjuna.com), Peter Furniss, Mark Little (mark.little@arjuna.com) Malik SAHEB (malik.saheb@arjuna.com

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GenericRecoveryCoordinator() protected constructor used by default servant derived class (with POA orbs).
	GenericRecoveryCoordinator(Uid RCUid, Uid actionUid, Uid processUid, boolean isServerTransaction) Normal constructor.

Method Summary

Modifier and Type	Method and Description
static String	makeId(Uid rcUid, Uid tranUid, Uid processUid, boolean isServerTransaction) Construct a string, to be used somehow in the objectkey (probably) of a RecoveryCoordinator reference.
static GenericRecoveryCoordinator	reconstruct(String encodedRCData) (re)construct a RecoveryCoordinator instance using the encoded information in the parameter.
protected static Status	replay_completion(RecoveryCoordinatorId id, Resource res) Respond to a replay_completion request for the RecoveryCoordinator identified by parameter id.
Status	replay_completion(Resource res) Implementation of IDL method:

Methods inherited from class org.omg.CosTransactions.RecoveryCoordinatorPOA

_all_interfaces, _invoke, _this, _this

Methods inherited from class org.omg.PortableServer.Servant

_default_POA, _get_delegate, _get_interface_def, _is_a, _non_existent, _object_id, _orb, _poa, _set_delegate, _this_object, _this_object

Methods inherited from class java.lang.Object

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

Constructor Detail

GenericRecoveryCoordinator

public GenericRecoveryCoordinator(Uid RCUid,
                                  Uid actionUid,
                                  Uid processUid,
                                  boolean isServerTransaction)

Normal constructor. Used both for creating a RecoveryCoordinator in the same process as the Coordinator (where this is necessary) and when reactivating a RecoveryCoordinator as an implementation instance (i.e. not as POA default servant) from stringified data in RecoveryManager from data received in a RecoveryCoordinator object key.

Combines the parameters into a RecoveryCoordinatorId.

GenericRecoveryCoordinator

protected GenericRecoveryCoordinator()

protected constructor used by default servant derived class (with POA orbs). When used a default servant, there is only one GenericRecoveryCoordinator instance, whose _id field is null.

Method Detail

replay_completion

public Status replay_completion(Resource res)
                         throws SystemException,
                                NotPrepared

Implementation of IDL method:

Operation: ::CosTransactions::RecoveryCoordinator::replay_completion.

  #pragma prefix "omg.org/CosTransactions/RecoveryCoordinator"
  ::CosTransactions::Status replay_completion(
  in ::CosTransactions::Resource r
  )
  raises(
  ::CosTransactions::NotPrepared
  );
  

This method is used when the instance is used as a particular implementation object (i.e. not as default servant). Delegates to the static replay_completion using the RecoveryCoordinatorId made in the constructor.

Throws:

SystemException

NotPrepared

replay_completion

protected static Status replay_completion(RecoveryCoordinatorId id,
                                          Resource res)
                                   throws SystemException,
                                          NotPrepared

Respond to a replay_completion request for the RecoveryCoordinator identified by parameter id.

Throws:

SystemException

NotPrepared

makeId

public static String makeId(Uid rcUid,
                            Uid tranUid,
                            Uid processUid,
                            boolean isServerTransaction)

Construct a string, to be used somehow in the objectkey (probably) of a RecoveryCoordinator reference. This will be deconstructed in the reconstruct() which is passed such a string, to remake the necessary RecoveryCoordinator when a replay_completion is received for it. Put here to make it in the same class as the deconstruction

reconstruct

public static GenericRecoveryCoordinator reconstruct(String encodedRCData)

(re)construct a RecoveryCoordinator instance using the encoded information in the parameter. The encoded information was (we hope) created using makeId and has been passed around as part of the object key in the RecoveryCoordinator IOR.