org.omg.CosTransactions
Class ControlPOATie

java.lang.Object
  |
  +--org.omg.PortableServer.Servant
        |
        +--org.omg.CosTransactions.ControlPOA
              |
              +--org.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, _get_interface, _is_a, _non_existent, _object_id, _orb, _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

Overrides:

_default_POA in class org.omg.PortableServer.Servant

get_terminator

public Terminator get_terminator()
                          throws Unavailable

Operation get_terminator

Following copied from interface: org.omg.CosTransactions.ControlOperations

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

Following copied from interface: org.omg.CosTransactions.ControlOperations

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.