org.omg.CosTransactions
Class ControlPOA
java.lang.Object
org.omg.PortableServer.Servant
org.omg.CosTransactions.ControlPOA
- All Implemented Interfaces:
- org.omg.CORBA.portable.InvokeHandler, ControlOperations
- Direct Known Subclasses:
- Control, ControlPOATie
public abstract class ControlPOA
- extends org.omg.PortableServer.Servant
- implements ControlOperations, org.omg.CORBA.portable.InvokeHandler
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.
Method Summary |
java.lang.String[] |
_all_interfaces(org.omg.PortableServer.POA poa,
byte[] objectId)
|
org.omg.CORBA.portable.OutputStream |
_invoke(java.lang.String opName,
org.omg.CORBA.portable.InputStream _is,
org.omg.CORBA.portable.ResponseHandler handler)
|
Control |
_this()
|
Control |
_this(org.omg.CORBA.ORB orb)
|
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 |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ControlPOA
public ControlPOA()
_this
public Control _this()
_this
public Control _this(org.omg.CORBA.ORB orb)
_all_interfaces
public java.lang.String[] _all_interfaces(org.omg.PortableServer.POA poa,
byte[] objectId)
- Specified by:
_all_interfaces
in class org.omg.PortableServer.Servant
_invoke
public final org.omg.CORBA.portable.OutputStream _invoke(java.lang.String opName,
org.omg.CORBA.portable.InputStream _is,
org.omg.CORBA.portable.ResponseHandler handler)
- Specified by:
_invoke
in interface org.omg.CORBA.portable.InvokeHandler