An object that registers to be notified of events generated by a
PooledConnection object.
The ConnectionEventListener interface is implemented by a
connection pooling component. A connection pooling component will
usually be provided by a JDBC driver vendor or another system software
vendor. A JDBC driver notifies a ConnectionEventListener
object when an application is finished using a pooled connection with
which the listener has registered. The notification
occurs after the application calls the method close on
its representation of a PooledConnection object. A
ConnectionEventListener is also notified when a
connection error occurs due to the fact that the PooledConnection
is unfit for future use---the server has crashed, for example.
The listener is notified by the JDBC driver just before the driver throws an
SQLException to the application using the
PooledConnection object. |