org.omg.CosTransactions
Class SubtransactionAwareResourcePOATie

java.lang.Object
  extended by org.omg.PortableServer.Servant
      extended by org.omg.CosTransactions.SubtransactionAwareResourcePOA
          extended by org.omg.CosTransactions.SubtransactionAwareResourcePOATie
All Implemented Interfaces:
org.omg.CORBA.portable.InvokeHandler, ResourceOperations, SubtransactionAwareResourceOperations

public class SubtransactionAwareResourcePOATie
extends SubtransactionAwareResourcePOA

Recoverable objects that implement nested transaction behavior may support a specialization of the Resource interface called the SubtransactionAwareResource interface. A recoverable object can be notified of the completion of a subtransaction by registering a specialized resource object that offers the SubtransactionAwareResource interface with the Transaction Service. This registration is done by using the register_resource or the register_subtran_aware operation of the current Coordinator object. A recoverable object generally uses the register_resource operation to register a resource that will participate in the completion of the top-level transaction and the register_subtran_aware operation to be notified of the completion of a subtransaction. Certain recoverable objects may want a finer control over the registration in the completion of a subtransaction. These recoverable objects will use the register_resource operation to ensure participation in the completion of the top-level transaction and they will use the register_subtran_aware operation to be notified of the completion of a particular subtransaction. For example, a recoverable object can use the register_subtran_aware operation to establish a "committed with respect to" relationship between transactions; that is, the recoverable object wants to be informed when a particular subtransaction is committed and then perform certain operations on the transactions that depend on that transaction?s completion. This technique could be used to implement lock inheritance, for example. The Transaction Service uses the SubtransactionAwareResource interface on each Resource object registered with a subtransaction. Each object supporting this interface is implicitly associated with a single subtransaction.


Constructor Summary
SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations tieObject)
          Constructor
SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations tieObject, org.omg.PortableServer.POA poa)
          Constructor
 
Method Summary
 org.omg.PortableServer.POA _default_POA()
          _default_POA method
 SubtransactionAwareResourceOperations _delegate()
          Get the delegate
 void _delegate(SubtransactionAwareResourceOperations delegate_)
          Set the delegate
 void commit_one_phase()
          Operation commit_one_phase
 void commit_subtransaction(Coordinator parent)
          Operation commit_subtransaction
 void commit()
          Operation commit
 void forget()
          Operation forget
 Vote prepare()
          Operation prepare
 void rollback_subtransaction()
          Operation rollback_subtransaction
 void rollback()
          Operation rollback
 
Methods inherited from class org.omg.CosTransactions.SubtransactionAwareResourcePOA
_all_interfaces, _invoke, _this, _this
 
Methods inherited from class org.omg.PortableServer.Servant
_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
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SubtransactionAwareResourcePOATie

public SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations tieObject)
Constructor


SubtransactionAwareResourcePOATie

public SubtransactionAwareResourcePOATie(SubtransactionAwareResourceOperations tieObject,
                                         org.omg.PortableServer.POA poa)
Constructor

Method Detail

_delegate

public SubtransactionAwareResourceOperations _delegate()
Get the delegate


_delegate

public void _delegate(SubtransactionAwareResourceOperations delegate_)
Set the delegate


_default_POA

public org.omg.PortableServer.POA _default_POA()
_default_POA method

Overrides:
_default_POA in class org.omg.PortableServer.Servant

commit_subtransaction

public void commit_subtransaction(Coordinator parent)
Operation commit_subtransaction


rollback_subtransaction

public void rollback_subtransaction()
Operation rollback_subtransaction


prepare

public Vote prepare()
             throws HeuristicMixed,
                    HeuristicHazard
Operation prepare

Throws:
HeuristicMixed
HeuristicHazard

rollback

public void rollback()
              throws HeuristicCommit,
                     HeuristicMixed,
                     HeuristicHazard
Operation rollback

Throws:
HeuristicCommit
HeuristicMixed
HeuristicHazard

commit

public void commit()
            throws NotPrepared,
                   HeuristicRollback,
                   HeuristicMixed,
                   HeuristicHazard
Operation commit

Throws:
NotPrepared
HeuristicRollback
HeuristicMixed
HeuristicHazard

commit_one_phase

public void commit_one_phase()
                      throws HeuristicHazard
Operation commit_one_phase

Throws:
HeuristicHazard

forget

public void forget()
Operation forget