Интерфейс 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, базовый подготовленный оператор возвращается в пул для повторного использования, а не закрывается.