com.atomikos.icatch.jta.template

Class TransactionTemplate

java.lang.Object

com.atomikos.icatch.jta.template.TransactionTemplate

public class TransactionTemplate
extends java.lang.Object

Template (builder-style) logic for light-weight transaction demarcation. Example usage:

 
     TransactionTemplate template = new TransactionTemplate();
     template.withTimeout(5).required().execute(() -> {
         //your transactional code as a lambda expression
     });
  
 

Instead of a lambda expression, you can also supply a Callable instance.

Field Summary

Fields

Modifier and Type	Field and Description
protected javax.transaction.TransactionManager	utm

Constructor Summary

Constructors

Constructor and Description
TransactionTemplate()

Method Summary

Modifier and Type	Method and Description
protected void	beginTransaction()
protected void	beginTransactionIfNoneExists()
protected void	commitTransactionIfStartedHere()
<T> T	execute(java.util.concurrent.Callable<T> work) Defaults to required() strategy.
protected void	forceRollback(java.lang.Throwable e)
TransactionTemplate	mandatory()
TransactionTemplate	nested()
TransactionTemplate	never()
TransactionTemplate	notSupported()
TransactionTemplate	required()
TransactionTemplate	requiresNew()
protected void	resumeExistingTransaction()
TransactionTemplate	supports()
protected void	suspendExistingTransaction()
TransactionTemplate	withTimeout(int timeout)

Methods inherited from class java.lang.Object

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

Field Detail

utm

protected javax.transaction.TransactionManager utm

Constructor Detail

TransactionTemplate

public TransactionTemplate()

Method Detail

withTimeout

public TransactionTemplate withTimeout(int timeout)

required

public TransactionTemplate required()

Returns:

An instance that executes work with REQUIRED semantics.

• For new transactions: any exception will lead to rollback, no exception means commit.
• For existing transactions: any exception will mark the transaction as rollbackOnly.

nested

public TransactionTemplate nested()

Returns:

An instance that executes work in a new (nested) transaction and commits if there are no exceptions. Any exception will lead to rollback of the (nested) transaction.

beginTransaction

protected void beginTransaction()
                         throws java.lang.Exception

Throws:

java.lang.Exception

commitTransactionIfStartedHere

protected void commitTransactionIfStartedHere()
                                       throws java.lang.Exception

Throws:

java.lang.Exception

forceRollback

protected void forceRollback(java.lang.Throwable e)
                      throws java.lang.Exception

Throws:

java.lang.Exception

beginTransactionIfNoneExists

protected void beginTransactionIfNoneExists()
                                     throws java.lang.Exception

Throws:

java.lang.Exception

resumeExistingTransaction

protected void resumeExistingTransaction()
                                  throws java.lang.Exception

Throws:

java.lang.Exception

suspendExistingTransaction

protected void suspendExistingTransaction()
                                   throws java.lang.Exception

Throws:

java.lang.Exception

execute

public <T> T execute(java.util.concurrent.Callable<T> work)
              throws java.lang.Exception

Defaults to required() strategy.

Parameters:

work -

Returns:

Throws:

java.lang.Exception

requiresNew

public TransactionTemplate requiresNew()

Returns:

An instance that executes work with REQUIRES_NEW semantics. Any exception will lead to rollback, no exception means commit.

mandatory

public TransactionTemplate mandatory()

Returns:

An instance that executes work with MANDATORY semantics. Any exception will lead to rollbackOnly status of the existing transaction.

never

public TransactionTemplate never()

Returns:

An instance that executes work with NEVER semantics.

supports

public TransactionTemplate supports()

Returns:

An instance that executes work with SUPPORTS semantics.

notSupported

public TransactionTemplate notSupported()

Returns:

An instance that executes work with NOT_SUPPORTED semantics.