Интерфейс 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. Когда используется пул подготовленных запросов, управляющий пулом уведомляется, поскольку он зарегистрировался как объект StatementEventListener, используя метод ConnectionPool addStatementEventListener. Таким образом, когда приложение закрывает свой PreparedStatement, лежащий в основе подготовленный запрос повторно используется, а не закрывается.