org.springframework.data.transaction

Class ChainedTransactionManager

java.lang.Object

org.springframework.data.transaction.ChainedTransactionManager

All Implemented Interfaces:

PlatformTransactionManager, TransactionManager

Deprecated.

since 2.5

@Deprecated
public class ChainedTransactionManager
extends Object
implements PlatformTransactionManager

PlatformTransactionManager implementation that orchestrates transaction creation, commits and rollbacks to a list of delegates. Using this implementation assumes that errors causing a transaction rollback will usually happen before the transaction completion or during the commit of the most inner PlatformTransactionManager.

The configured instances will start transactions in the order given and commit/rollback in reverse order, which means the PlatformTransactionManager most likely to break the transaction should be the last in the list configured. A PlatformTransactionManager throwing an exception during commit will automatically cause the remaining transaction managers to roll back instead of committing.

As consequence, a transaction can get into a state, where the first PlatformTransactionManager has committed its transaction and a subsequent PlatformTransactionManager failed to commit its transaction (e.g. caused by an I/O error or the transactional resource failed to commit for other reasons). In that case, commit(TransactionStatus) throws a HeuristicCompletionException to indicate a partially committed transaction. Rollback isn't affected as the natural consequence of a missing commit is a rollback of a transactional resource. ChainedTransactionManager should be only used if the application can tolerate or recover from inconsistent state caused by partially committed transactions. In any other case, the use of ChainedTransactionManager is not recommended.

Instead of using ChainedTransactionManager for attaching callbacks to transaction commit (pre commit/post commit), either register a TransactionSynchronization to explicitly follow transaction cleanup with simplified semantics in case of exceptions.

Since:

1.6

Author:

Michael Hunger, Oliver Gierke, Mark Paluch

See Also:

TransactionSynchronization.beforeCommit(boolean), TransactionSynchronization.afterCommit()

Constructor Summary

Constructors

Constructor and Description
ChainedTransactionManager(PlatformTransactionManager... transactionManagers) Deprecated. Creates a new ChainedTransactionManager delegating to the given PlatformTransactionManagers.

Method Summary

Modifier and Type	Method and Description
void	commit(TransactionStatus status) Deprecated.
org.springframework.data.transaction.MultiTransactionStatus	getTransaction(TransactionDefinition definition) Deprecated.
void	rollback(TransactionStatus status) Deprecated.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ChainedTransactionManager

public ChainedTransactionManager(PlatformTransactionManager... transactionManagers)

Deprecated.

Creates a new ChainedTransactionManager delegating to the given PlatformTransactionManagers.

Parameters:

transactionManagers - must not be null or empty.

Method Detail

getTransaction

public org.springframework.data.transaction.MultiTransactionStatus getTransaction(@Nullable
                                                                                  TransactionDefinition definition)
                                                                           throws TransactionException

Deprecated.

Specified by:

getTransaction in interface PlatformTransactionManager

Throws:

TransactionException

commit

public void commit(TransactionStatus status)
            throws TransactionException

Deprecated.

Specified by:

commit in interface PlatformTransactionManager

Throws:

TransactionException

rollback

public void rollback(TransactionStatus status)
              throws TransactionException

Deprecated.

Specified by:

rollback in interface PlatformTransactionManager

Throws:

TransactionException