Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface PooledConnection
PooledConnection
объект представляет физическое соединение с источником данных. Соединение может быть переработано вместо того, чтобы быть закрытым, когда приложение заканчивается с ним, таким образом сокращая количество соединений, которые должны быть сделаны. Прикладной программист не использует PooledConnection
взаимодействуйте через интерфейс непосредственно; скорее это используется инфраструктурой среднего уровня, которая управляет объединением в пул соединений.
Когда приложение вызывает метод DataSource.getConnection
, это возвращает a Connection
объект. Если объединение в пул соединения делается, это Connection
объект является фактически дескриптором к a PooledConnection
объект, который является физическим соединением.
Менеджер по пулу соединения, обычно сервер приложений, поддерживает пул PooledConnection
объекты. Если есть a PooledConnection
объект, доступный в пуле, менеджер по пулу соединения возвращает a Connection
объект, который является дескриптором к тому физическому соединению. Если нет PooledConnection
объект доступен, менеджер по пулу соединения вызывает ConnectionPoolDataSource
метод getPoolConnection
создать новое физическое соединение. Реализация драйвера JDBC ConnectionPoolDataSource
создает новое PooledConnection
возразите и возвращает дескриптор этому.
Когда приложение закрывает соединение, оно вызывает Connection
метод close
. Когда объединение в пул соединения делается, менеджер по пулу соединения уведомляется, потому что оно зарегистрировало себя как a ConnectionEventListener
объект используя ConnectionPool
метод addConnectionEventListener
. Менеджер по пулу соединения деактивировал дескриптор к PooledConnection
возразите и возвращается PooledConnection
возразите против пула соединений так, чтобы он мог использоваться снова. Таким образом, когда приложение закрывает свое соединение, базовое физическое соединение перерабатывается вместо того, чтобы быть закрытым.
Физическое соединение не закрывается, пока менеджер по пулу соединения не вызывает PooledConnection
метод close
. Этот метод обычно вызывают, чтобы иметь аккуратное завершение работы сервера или если фатальная ошибка сделала соединение неприменимым.
Менеджер по пулу соединения является часто также пулом оператора менеджер, maintining пул PreparedStatement
объекты. Когда приложение закрывает готовый оператор, оно вызывает PreparedStatement
метод close
. Когда Statement
объединение в пул делается, менеджер по пулу уведомляется, потому что оно зарегистрировало себя как a StatementEventListener
объект используя ConnectionPool
метод addStatementEventListener
. Таким образом, когда приложение закрывает PreparedStatement
, базовый готовый оператор перерабатывается вместо того, чтобы быть закрытым.
Модификатор и Тип | Метод и Описание |
---|---|
void |
addConnectionEventListener(ConnectionEventListener listener)
Регистрирует данного слушателя события так, чтобы это было уведомлено, когда событие будет иметь место на этом
PooledConnection объект. |
void |
addStatementEventListener(StatementEventListener listener)
Регистры a
StatementEventListener с этим PooledConnection объект. |
void |
close()
Закрывает физическое соединение что это
PooledConnection объект представляет. |
Соединение |
getConnection()
Создает и возвращает a
Connection объект, который является дескриптором для физического соединения что это PooledConnection объект представляет. |
void |
removeConnectionEventListener(ConnectionEventListener listener)
Удаляет данного слушателя события из списка компонентов, которые будут уведомлены, когда событие будет иметь место на этом
PooledConnection объект. |
void |
removeStatementEventListener(StatementEventListener listener)
Удаляет указанное
StatementEventListener от списка компонентов, которые будут уведомлены, когда драйвер обнаружит это a PreparedStatement был закрыт или недопустим. |
Connection getConnection() throws SQLException
Connection
объект, который является дескриптором для физического соединения что это PooledConnection
объект представляет. Менеджер по пулу соединения вызывает этот метод, когда приложение вызвало метод DataSource.getConnection
и есть нет PooledConnection
доступные объекты. См. interface description
для получения дополнительной информации.Connection
объект, который является дескриптором к этому PooledConnection
объектSQLException
- если ошибка доступа к базе данных происходитSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid close() throws SQLException
PooledConnection
объект представляет. Приложение никогда не вызывает этот метод непосредственно; это вызывает модуль пула соединения, или менеджер. См. interface description
для получения дополнительной информации.
SQLException
- если ошибка доступа к базе данных происходитSQLFeatureNotSupportedException
- если драйвер JDBC не поддерживает этот методvoid addConnectionEventListener(ConnectionEventListener listener)
PooledConnection
объект.listener
- компонент, обычно менеджер по пулу соединения, который реализовал ConnectionEventListener
взаимодействуйте через интерфейс и хочет быть уведомленным, когда соединение закрывается или имеет ошибкуremoveConnectionEventListener(javax.sql.ConnectionEventListener)
void removeConnectionEventListener(ConnectionEventListener listener)
PooledConnection
объект.listener
- компонент, обычно менеджер по пулу соединения, который реализовал ConnectionEventListener
взаимодействуйте через интерфейс и зарегистрированный в этом PooledConnection
возразите как слушательaddConnectionEventListener(javax.sql.ConnectionEventListener)
void addStatementEventListener(StatementEventListener listener)
StatementEventListener
с этим PooledConnection
объект. Компоненты, которые хотят быть уведомленными когда PreparedStatement
s создаваемый соединением закрываются или обнаруживаются, чтобы быть недопустимыми, может использовать этот метод, чтобы зарегистрировать a StatementEventListener
с этим PooledConnection
объект. listener
- компонент, который реализует StatementEventListener
интерфейс, который должен быть зарегистрирован в этом PooledConnection
объект void removeStatementEventListener(StatementEventListener listener)
StatementEventListener
от списка компонентов, которые будут уведомлены, когда драйвер обнаружит это a PreparedStatement
был закрыт или недопустим. listener
- компонент, который реализует StatementEventListener
интерфейс, который был ранее зарегистрирован в этом PooledConnection
объект
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92