org.modeshape.schematic

Interface TransactionListener

All Known Subinterfaces:

SchematicDb

All Known Implementing Classes:

FileDb, RelationalDb

public interface TransactionListener

Notification interface which is used by ModeShape to tell a 3rd party (typically a SchematicDb) when a transaction has been started, committed or rolled back from ModeShape's perspective. It also informs when locks have been obtained by ModeShape on certain resources.

Since ModeShape supports both user-managed transactions and internal transactions, the notification methods from this interface may be called in different contexts. For example, for a ModeShape-managed transaction the txStarted(String) method will be called immediately after ModeShape starts a new transaction and the txCommitted(String) or txRolledback(String) methods right after ModeShape has committed or rolled back the transaction.

On the other hand, for a non ModeShape-managed transaction the txStarted(String) method will be called once ModeShape detects an active external transaction (which may've been created a while back) while the txCommitted(String) and txRolledback(String) methods will be called once the external transaction notifies ModeShape via a transaction synchronization.

Since:

5.0

Method Summary

Modifier and Type	Method and Description
void	txCommitted(String id) Called by ModeShape once an existing transaction has been successfully committed.
void	txRolledback(String id) Called to indicate tha a transaction has been rolled back.
void	txStarted(String id) Called by ModeShape once a ModeShape transaction has been created.

Method Detail

txStarted

void txStarted(String id)

Called by ModeShape once a ModeShape transaction has been created.

Parameters:

id - the tx id; never null

txCommitted

void txCommitted(String id)

Called by ModeShape once an existing transaction has been successfully committed. This may be either a single ModeShape transaction or a longer-spanning user transaction.

Parameters:

id - the tx id; never null

txRolledback

void txRolledback(String id)

Called to indicate tha a transaction has been rolled back.

Parameters:

id - the tx id; never null