Since: API Level 1
public interface

ConnectionEventListener

implements EventListener
javax.sql.ConnectionEventListener

Class Overview

An interface used to receive events generated by a PooledConnection.

This interface would typically be implemented by a component which manages a connection pool (a connection pool manager). A connection triggers an event 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.

The connection pool manager can return closed connections to the pool for later reuse. Connections experiencing an error should be discarded.

Summary

Public Methods
abstract void connectionClosed(ConnectionEvent theEvent)
Notifies the ConnectionEventListener that an application has called the close method on a pooled connection.
abstract void connectionErrorOccurred(ConnectionEvent theEvent)
Notifies the ConnectionEventListener that an error has occurred on a PooledConnection.

Public Methods

public abstract void connectionClosed (ConnectionEvent theEvent)

Since: API Level 1

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

Parameters
theEvent a ConnectionEvent containing details about the source of the event.

public abstract void connectionErrorOccurred (ConnectionEvent theEvent)

Since: API Level 1

Notifies the ConnectionEventListener that an error has occurred on a PooledConnection. This notification is triggered before the SQLException, which is available through the event argument, is thrown.

Parameters
theEvent a ConnectionEvent containing details about the source of the event and the SQLException that has occurred.