org.omg.CosTransactions
Class _ControlStub

java.lang.Object
  extended byorg.omg.CORBA.portable.ObjectImpl
      extended byorg.omg.CosTransactions._ControlStub
All Implemented Interfaces:
Control, ControlOperations, org.omg.CORBA.portable.IDLEntity, org.omg.CORBA.Object, java.io.Serializable

public class _ControlStub
extends org.omg.CORBA.portable.ObjectImpl
implements Control

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.

See Also:
Serialized Form

Constructor Summary
_ControlStub()
           
 
Method Summary
 java.lang.String[] _ids()
           
 Coordinator get_coordinator()
          Operation get_coordinator
 Terminator get_terminator()
          Operation get_terminator
 
Methods inherited from class org.omg.CORBA.portable.ObjectImpl
_create_request, _create_request, _duplicate, _get_delegate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _invoke, _is_a, _is_equivalent, _is_local, _non_existent, _orb, _release, _releaseReply, _request, _request, _servant_postinvoke, _servant_preinvoke, _set_delegate, _set_policy_override, equals, hashCode, toString
 
Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface org.omg.CORBA.Object
_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override
 

Constructor Detail

_ControlStub

public _ControlStub()
Method Detail

_ids

public java.lang.String[] _ids()

get_terminator

public Terminator get_terminator()
                          throws Unavailable
Operation get_terminator

Specified by:
get_terminator in interface 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

Specified by:
get_coordinator in interface 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.