net.sf.mmm.transaction.api

Interface TransactionAdapter

All Known Implementing Classes:

AbstractTransactionExecutor.AbstractTransactionAdapter, JpaTransactionExecutor.JpaTransactionAdapter, JtaTransactionExecutor.JtaTransactionAdapter, NoTransactionExecutor.NoTransactionAdapter, SpringTransactionExecutor.SpringTransactionAdapter

public interface TransactionAdapter

This interface adapts underlying transactions.

Author:

Joerg Hohwiller (hohwille at users.sourceforge.net)

See Also:

TransactionCallable

Method Summary

Modifier and Type	Method and Description
void	commit() This method commits the current transaction without opening a new transaction.
TransactionContext	getContext() This method gets the TransactionContext that allows to add individual data to be associated with this TransactionAdapter.
void	interCommit() This method commits the transaction currently active and opens a new one.
boolean	isActive() This method determines if this context holds an active transaction.
void	rollback() This method performs a rollback of the current transaction.

Method Detail

interCommit

void interCommit()

This method commits the transaction currently active and opens a new one. You should use this method for (recoverable) batches that process large sets of data and therefore would overload if everything was done in one technical transaction.

commit

void commit()

This method commits the current transaction without opening a new transaction. It allows to throw an exception in your callable but end with a commit rather than a rollback().
ATTENTION:
Please only use this method as end-user if there is no other way to solve your problem.

rollback

void rollback()

This method performs a rollback of the current transaction. It allows to return from your callable without committing and or throwing an exception.
ATTENTION:
Please only use this method as end-user if there is no other way to solve your problem.

isActive

boolean isActive()

This method determines if this context holds an active transaction.
This is the case until commit() or rollback() was called explicitly.

Returns:

true if there is an active transaction or false otherwise.

getContext

TransactionContext getContext()

This method gets the TransactionContext that allows to add individual data to be associated with this TransactionAdapter.

Returns:

the TransactionContext.