org.objectweb.transaction.jta

Interface ResourceManagerEventListener

Known Subinterfaces:
TransactionManager
Known Implementing Classes:
Current

public interface ResourceManagerEventListener

A ResourceManagerEventListener allows late enrolment of connections that are opened in the thread before the transaction starts.

Resource Managers that support registration of ResourceManagerEventListener will be able to notify the transaction manager of connections opened without transaction context and get a callback from the transaction manager when the transaction begins.
In a typical Resource Manager, the registration of the listener is made by the application server via mutator method such as ResourceManager. setResourceManagerEventListener(listener).

Author:
Christophe Ney cney@batisseurs.com for Lutris Technologies

Method Summary

void
connectionClosed(ResourceManagerEvent event)
This method is called by the resource manager when a logical connection that was opened without transaction context is closed.
void
connectionErrorOccured(ResourceManagerEvent event)
This method is called by the resource manager when a logical connection that was opened without transaction context is about to throw an exception.
void
connectionOpened(ResourceManagerEvent event)
This method is called by the resource manager when a getConnection call is made without a transaction context.

Method Details

connectionClosed

public void connectionClosed(ResourceManagerEvent event)
This method is called by the resource manager when a logical connection that was opened without transaction context is closed. It is to be used by the listener to keep track of those events and perform clean-up.

Parameters:
event - event sent to the listener


connectionErrorOccured

public void connectionErrorOccured(ResourceManagerEvent event)
This method is called by the resource manager when a logical connection that was opened without transaction context is about to throw an exception. It is to be used by the listener to keep track of those events and perform clean-up.

Parameters:
event - event sent to the listener


connectionOpened

public void connectionOpened(ResourceManagerEvent event)
This method is called by the resource manager when a getConnection call is made without a transaction context. The ResourceManagerEvent is to be used by the listener to keep track of those events and perform a late enrolment of those logical connection when the transaction begins.

Parameters:
event - event sent to the listener