com.atomikos.icatch

Interface ImportingTransactionManager

public interface ImportingTransactionManager

Represents a handle to import a transaction from an incoming request, so that the work in this VM becomes part of the request's commit or rollback.

Method Summary

Modifier and Type	Method and Description
CompositeTransaction	importTransaction(Propagation propagation) Imports the transaction propagation obtained from an incoming request.
Extent	terminated(boolean commit) Signals that the incoming request is done processing, in order to terminate the transaction context for the calling thread.

Method Detail

importTransaction

CompositeTransaction importTransaction(Propagation propagation)
                                throws java.lang.IllegalArgumentException,
                                       SysException

Imports the transaction propagation obtained from an incoming request.

Parameters:

propagation - The propagation (transaction context).

Returns:

CompositeTransaction The locally created transaction instance that takes part in the global commit/rollback. This instance will also be mapped to the calling thread.

Throws:

java.lang.IllegalArgumentException - If the supplied propagation cannot be understood.

SysException

terminated

Extent terminated(boolean commit)
           throws SysException,
                  RollbackException

Signals that the incoming request is done processing, in order to terminate the transaction context for the calling thread.

Parameters:

commit - True if the invocation had no errors: commit the local transaction but make its final outcome subject to the request's commit/rollback.

Returns:

Extent The extent to return to remote client (i.e., the participant information for two-phase commit) along with the parent's ID for asynchronous calls.

Throws:

RollbackException - If no transaction exists, e.g. if it has been rolled back already.

SysException