com.haulmont.cuba.core

Interface Transaction

All Superinterfaces:

java.lang.AutoCloseable

All Known Implementing Classes:

TransactionImpl

public interface Transaction
extends java.lang.AutoCloseable

Programmatic transaction control interface.

Use it in a try-with-resources block:

     try (Transaction tx = transactions.create()) {
         // transactional code here
         tx.commit();
     }
 

See Also:

Transactions, Persistence

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	Transaction.Callable<T> Interface for transactional code.
static interface	Transaction.Runnable Interface for transactional code that is not intended to return a result.

Method Summary

Modifier and Type	Method and Description
void	close()
void	commit() Commit current transaction.
void	commitRetaining() Commit current transaction and immediately start a new one.
void	end() This method has to be invoked in the following construct:
<T> T	execute(java.lang.String storeName, Transaction.Callable<T> callable) Executes the action specified by the given single method object within a transaction.
void	execute(java.lang.String storeName, Transaction.Runnable runnable) Executes the action specified by the given single method object within a transaction.
<T> T	execute(Transaction.Callable<T> callable) Executes the action specified by the given single method object within a transaction in the main data store.
void	execute(Transaction.Runnable runnable) Executes the action specified by the given single method object within a transaction in the main data store.

Method Detail

execute

<T> T execute(Transaction.Callable<T> callable)

Executes the action specified by the given single method object within a transaction in the main data store.

See Also:

execute(String, Callable)

execute

<T> T execute(java.lang.String storeName,
              Transaction.Callable<T> callable)

Executes the action specified by the given single method object within a transaction.
Returns a result object created within the transaction.
A RuntimeException thrown in the transactional code enforces a rollback.

Type Parameters:

T - result type

Parameters:

storeName - data store name

callable - transactional code in the form of Transaction.Callable

Returns:

result object

execute

void execute(Transaction.Runnable runnable)

Executes the action specified by the given single method object within a transaction in the main data store.

See Also:

execute(String, Runnable)

execute

void execute(java.lang.String storeName,
             Transaction.Runnable runnable)

Executes the action specified by the given single method object within a transaction.
A RuntimeException thrown in the transactional code enforces a rollback.

Parameters:

storeName - data store name

runnable - transactional code in the form of Runnable

commit

void commit()

Commit current transaction.

commitRetaining

void commitRetaining()

Commit current transaction and immediately start a new one.

end

void end()

This method has to be invoked in the following construct:

     Transaction tx = ...
     try {
         ...
         tx.commit();
     } finally {
         tx.end();
     }
 

In case of successful commit this method does nothing. Otherwise it rollbacks the current transaction.

close

void close()

Specified by:

close in interface java.lang.AutoCloseable