org.omg.CosTransactions
Interface TransactionFactoryOperations
- All Known Subinterfaces:
- TransactionFactory
- All Known Implementing Classes:
- _TransactionFactoryStub, TransactionFactoryPOA
- public interface TransactionFactoryOperations
The TransactionFactory interface is provided to allow the transaction originator to
begin a transaction. This interface defines two operations, create and recreate, which
create a new representation of a top-level transaction.
Method Summary |
Control |
create(int time_out)
A new top-level transaction is created and a Control object is returned. |
Control |
recreate(PropagationContext ctx)
A new representation is created for an existing transaction defined by the
PropagationContext and a Control object is returned. |
create
public Control create(int time_out)
- A new top-level transaction is created and a Control object is returned. The Control
object can be used to manage or to control participation in the new 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 by the client thread.
If the parameter has a nonzero value n, then the new transaction will be subject to being
rolled back if it does not complete before n seconds have elapsed. If the parameter is zero,
then no application specified time-out is established.
recreate
public Control recreate(PropagationContext ctx)
- A new representation is created for an existing transaction defined by the
PropagationContext and a Control object is returned. The Control object can be used
to manage or to control participation in the transaction. An implementation of the
Transaction Service which supports interposition uses recreate to create a new representation
of the transaction being imported, subordinate to the representation in ctx. The recreate
operation can also be used to import a transaction which originated outside of the
Transaction Service.