javax.sql
Interface ConnectionEventListener

All Superinterfaces:

EventListener

public interface ConnectionEventListener
extends EventListener

An interface used to receive events generated by a PooledConnection.

This interface would typically be implemented by a component which implements Connection Pooling (a Connection Pool Manager). A Connection will signal events to a ConnectionEventListener either when the application closes a Connection it has been using or when a significant error occurs while the Connection is being used, where the Connection should not be used again.

The Connection Pool Manager can return closed Connections to the Pool for later reuse. Connections experiencing an error should be discarded.

Method Summary

void	connectionClosed(ConnectionEvent theEvent) Notifies the ConnectionEventListener that an application has called the close method on a pooled Connection.
void	connectionErrorOccurred(ConnectionEvent theEvent) Notifies the ConnectionEventListener that an error has occurred while a PooledConnection was being used and that the PooledConnection can no longer be used for work.

Method Detail

connectionClosed

void connectionClosed(ConnectionEvent theEvent)

Notifies the ConnectionEventListener that an application has called the close method on a pooled Connection.

Parameters:

theEvent - a ConnectionEvent containing detail about the source of the event.

connectionErrorOccurred

void connectionErrorOccurred(ConnectionEvent theEvent)

Notifies the ConnectionEventListener that an error has occurred while a PooledConnection was being used and that the PooledConnection can no longer be used for work. This notification is done just before the SQLException passed in the event message is thrown to the application.

Parameters:

theEvent - a ConnectionEvent containing detail about the source of the event and the SQLException that has occurred.