Интерфейс PooledConnection

public interface PooledConnection

Объект, предоставляющий средства для управления пулом соединений. Объект PooledConnection представляет собой физическое соединение с источником данных. Соединение может быть повторно использовано вместо закрытия, когда приложение с ним закончит работу, что уменьшает количество необходимых подключений.

Программист приложения не использует интерфейс PooledConnection напрямую; он используется инфраструктурой среднего уровня, которая управляет пулом соединений.

Когда приложение вызывает метод DataSource.getConnection, оно получает объект Connection. Если используется пул соединений, этот объект Connection фактически является обработчиком объекта PooledConnection, представляющего физическое соединение.

Менеджер пула соединений, как правило, сервер приложения, поддерживает пул объектов PooledConnection. Если в пуле доступен объект PooledConnection, менеджер пула соединений возвращает объект Connection, являющийся обработчиком этого физического соединения. Если доступных объектов PooledConnection нет, менеджер пула соединений вызывает метод ConnectionPoolDataSource getPoolConnection для создания нового физического соединения. Драйвер JDBC, реализующий ConnectionPoolDataSource, создаёт новый объект PooledConnection и возвращает обработчик к нему.

Когда приложение закрывает соединение, оно вызывает метод Connection close. При использовании пула соединений менеджер пула уведомляется, так как он зарегистрировал себя как объект ConnectionEventListener с помощью метода ConnectionPool addConnectionEventListener. Менеджер пула деактивирует обработчик объекта PooledConnection и возвращает объект PooledConnection в пул соединений, чтобы он мог быть повторно использован. Таким образом, когда приложение закрывает соединение, основное физическое соединение повторно используется вместо закрытия.

Если менеджер пула соединений оборачивает или предоставляет прокси для логического обработчика, возвращаемого при вызове PoolConnection.getConnection, менеджер пула должен выполнить одно из следующих действий, когда менеджер пула закрывает или возвращает PooledConnection в пул в ответ на вызов приложения Connection.close:

• вызов endRequest для логического обработчика Connection
• вызов close для логического обработчика Connection

Физическое соединение не закрывается до тех пор, пока менеджер пула соединений не вызовет метод PooledConnection close. Этот метод обычно используется для упорядоченного завершения работы сервера или если критическое сообщение сделало соединение непригодным для использования.

Менеджер пула соединений часто также является менеджером пула операторов, поддерживая пул объектов PreparedStatement. Когда приложение закрывает подготовленный оператор, оно вызывает метод PreparedStatement close. При использовании пула Statement менеджер пула уведомляется, потому что он зарегистрировал себя как объект StatementEventListener с помощью метода ConnectionPool addStatementEventListener. Таким образом, когда приложение закрывает свой PreparedStatement, подлежащий подготовке оператор повторно используется вместо закрытия.