Интерфейс 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 в пул в ответ на вызов приложения %%%CODE_BLOCK_25%%:

• вызвать endRequest на логической Connection ссылке
• вызвать close на логической Connection ссылке

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

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