org.omg.CosTransactions
Class ControlPOATie

java.lang.Object
  extended byorg.omg.PortableServer.Servant
      extended byorg.omg.CosTransactions.ControlPOA
          extended byorg.omg.CosTransactions.ControlPOATie
All Implemented Interfaces:
ControlOperations, org.omg.CORBA.portable.InvokeHandler

public class ControlPOATie
extends ControlPOA

The Control interface allows a program to explicitly manage or propagate a transaction context. An object supporting the Control interface is implicitly associated with one specific transaction. The Control interface defines two operations, get_terminator and get_coordinator. The get_terminator operation returns a Terminator object, which supports operations to end the transaction. The get_coordinator operation returns a Coordinator object, which supports operations needed by resources to participate in the transaction. The two objects support operations that are typically performed by different parties. Providing two objects allows each set of operations to be made available only to the parties that require those operations. A Control object for a transaction is obtained using the operations defined by the TransactionFactory interface or the create_subtransaction operation defined by the Coordinator interface. It is possible to obtain a Control object for the current transaction (associated with a thread) using the get_control or suspend operations defined by the Current interface. (These two operations return a null object reference if there is no current transaction.) An implementation of the Transaction Service may restrict the ability for the Control object to be transmitted to or used in other execution environments; at a minimum, it can be used within a single thread.


Constructor Summary
ControlPOATie(ControlOperations tieObject)
          Constructor
ControlPOATie(ControlOperations tieObject, org.omg.PortableServer.POA poa)
          Constructor
 
Method Summary
 org.omg.PortableServer.POA _default_POA()
          _default_POA method
 ControlOperations _delegate()
          Get the delegate
 void _delegate(ControlOperations delegate_)
          Set the delegate
 Coordinator get_coordinator()
          Operation get_coordinator
 Terminator get_terminator()
          Operation get_terminator
 
Methods inherited from class org.omg.CosTransactions.ControlPOA
_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

ControlPOATie

public ControlPOATie(ControlOperations tieObject)
Constructor


ControlPOATie

public ControlPOATie(ControlOperations tieObject,
                     org.omg.PortableServer.POA poa)
Constructor

Method Detail

_delegate

public ControlOperations _delegate()
Get the delegate


_delegate

public void _delegate(ControlOperations delegate_)
Set the delegate


_default_POA

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


get_terminator

public Terminator get_terminator()
                          throws Unavailable
Operation get_terminator

Returns:
An object is returned that supports the Terminator interface. The object can be used to rollback or commit the transaction associated with the Control.
Throws:
Unavailable - The Unavailable exception may be raised if the Control cannot provide the requested object.

get_coordinator

public Coordinator get_coordinator()
                            throws Unavailable
Operation get_coordinator

Returns:
An object is returned that supports the Coordinator interface. The object can be used to register resources for the transaction associated with the Control.
Throws:
Unavailable - The Unavailable exception may be raised if the Control cannot provide the requested object.