Package org.neo4j.graphdb.event

Interface TransactionEventListener<T>

Type Parameters:

T - The type of a state object that the transaction handler can use to pass information from the beforeCommit(TransactionData, Transaction, GraphDatabaseService) event dispatch method to the afterCommit(TransactionData, Object, GraphDatabaseService) or afterRollback(TransactionData, Object, GraphDatabaseService) method, depending on whether the transaction succeeded or failed.

public interface TransactionEventListener<T>

An event handler interface for transaction events. Once it has been registered at a DatabaseManagementService instance it will receive events about what has happened in each transaction which is about to be committed and has any data that is accessible via TransactionData. Handlers won't get notified about transactions which haven't performed any write operation or won't be committed (either if Transaction.commit() hasn't been called or the transaction has been rolled back, Transaction.rollback()).

Right before a transaction is about to be committed the beforeCommit(TransactionData, Transaction, GraphDatabaseService) method is called with the entire diff of modifications made in the transaction. At this point the transaction is still running so changes can still be made. However, there's no guarantee that other handlers will see such changes since the order in which handlers are executed is undefined. This method can also throw an exception and will, in such a case, prevent the transaction from being committed.

If beforeCommit(TransactionData, Transaction, GraphDatabaseService) is successfully executed the transaction will be committed and the afterCommit(TransactionData, Object, GraphDatabaseService) method will be called with the same transaction data as well as the object returned from beforeCommit(TransactionData, Transaction, GraphDatabaseService). This assumes that all other handlers (if more were registered) also executed beforeCommit(TransactionData, Transaction, GraphDatabaseService) successfully.

If beforeCommit(TransactionData, Transaction, GraphDatabaseService) isn't executed successfully, but instead throws an exception the transaction won't be committed. Transient errors of type TransientFailureException will (eventually) be rethrown. For all other errors a TransactionFailureException will (eventually) be thrown from Transaction.close(). All handlers which at this point have had its beforeCommit(TransactionData, Transaction, GraphDatabaseService) method executed successfully will receive a call to afterRollback(TransactionData, Object, GraphDatabaseService).

Method Summary

Modifier and Type	Method	Description
void	afterCommit(TransactionData data, T state, GraphDatabaseService databaseService)	Invoked after the transaction has been committed successfully.
void	afterRollback(TransactionData data, T state, GraphDatabaseService databaseService)	Invoked after the transaction has been rolled back if committing the transaction failed for some reason.
T	beforeCommit(TransactionData data, Transaction transaction, GraphDatabaseService databaseService)	Invoked when a transaction that has changes accessible via TransactionData is about to be committed.

Method Details

beforeCommit

T beforeCommit(TransactionData data,
 Transaction transaction,
 GraphDatabaseService databaseService)
        throws Exception

Invoked when a transaction that has changes accessible via TransactionData is about to be committed. If this method throws an exception the transaction will be rolled back and a TransactionFailureException or a TransientFailureException will be thrown from Transaction.close(). The transaction is still open when this method is invoked, making it possible to perform mutating operations in this method. This is however highly discouraged since changes made in this method are not guaranteed to be visible by this or other TransactionEventListeners.

Parameters:

data - the changes that will be committed in this transaction.

transaction - ongoing transaction

databaseService - underlying database service

Returns:

a state object (or null) that will be passed on to afterCommit(TransactionData, Object, GraphDatabaseService) or afterRollback(TransactionData, Object, GraphDatabaseService) of this object.

Throws:

Exception - to indicate that the transaction should be rolled back.

afterCommit

void afterCommit(TransactionData data,
 T state,
 GraphDatabaseService databaseService)

Invoked after the transaction has been committed successfully. Any TransactionData being passed in to this method is guaranteed to first have been called with beforeCommit(TransactionData, Transaction, GraphDatabaseService). At the point of calling this method the transaction have been closed and so accessing data outside that of what the TransactionData can provide will require a new transaction to be opened.

Parameters:

data - the changes that were committed in this transaction.

state - the object returned by beforeCommit(TransactionData, Transaction, GraphDatabaseService).

databaseService - underlying database service

afterRollback

void afterRollback(TransactionData data,
 T state,
 GraphDatabaseService databaseService)

Invoked after the transaction has been rolled back if committing the transaction failed for some reason. Any TransactionData being passed in to this method is guaranteed to first have been called with beforeCommit(TransactionData, Transaction, GraphDatabaseService). At the point of calling this method the transaction have been closed and so accessing data outside that of what the TransactionData can provide will require a new transaction to be opened.

Parameters:

data - the changes that were attempted to be committed in this transaction.

state - the object returned by beforeCommit(TransactionData, Transaction, GraphDatabaseService). If this handler failed when executing beforeCommit(TransactionData, Transaction, GraphDatabaseService) this state will be null.

databaseService - underlying database service