com.atomikos.icatch.ImportingTransactionManager Maven / Gradle / Ivy
/**
* Copyright (C) 2000-2023 Atomikos
*
* LICENSE CONDITIONS
*
* See http://www.atomikos.com/Main/WhichLicenseApplies for details.
*/
package com.atomikos.icatch;
/**
* 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.
*/
public interface ImportingTransactionManager
{
/**
* Imports the transaction propagation obtained from an incoming request.
*
* @param propagation The propagation (transaction context).
*
* @return 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 IllegalArgumentException If the supplied propagation cannot be understood.
*/
CompositeTransaction importTransaction(Propagation propagation) throws IllegalArgumentException, SysException;
/**
* Signals that the incoming request is done processing, in order to
* terminate the transaction context for the calling thread.
*
* @param commit True if the invocation had no errors: commit the local transaction
* but make its final outcome subject to the request's commit/rollback.
*
* @return 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.
*
*
*
*/
Extent terminated(boolean commit) throws SysException, RollbackException;
}