javax.sql
public
interface
javax.sql.ConnectionEventListener
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.
Summary
Details
Public Methods
public
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.
|
public
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.
|