javax.sql

Интерфейсный PooledConnection

Все Известные Подынтерфейсы:

XAConnection

public interface PooledConnection

Объект, который обеспечивает рычаги для управления пулом соединения. A 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, базовый готовый оператор перерабатывается вместо того, чтобы быть закрытым.

С тех пор:

1.4

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
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 был закрыт или недопустим.

Деталь метода

getConnection

Connection getConnection()
                         throws SQLException

Создает и возвращает a Connection объект, который является дескриптором для физического соединения что это PooledConnection объект представляет. Менеджер по пулу соединения вызывает этот метод, когда приложение вызвало метод DataSource.getConnection и есть нет PooledConnection доступные объекты. См. interface description для получения дополнительной информации.

Возвраты:

a Connection объект, который является дескриптором к этому PooledConnection объект

Броски:

SQLException - если ошибка доступа к базе данных происходит

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

близко

void close()
           throws SQLException

Закрывает физическое соединение что это PooledConnection объект представляет. Приложение никогда не вызывает этот метод непосредственно; это вызывает модуль пула соединения, или менеджер.

См. interface description для получения дополнительной информации.

Броски:

SQLException - если ошибка доступа к базе данных происходит

SQLFeatureNotSupportedException - если драйвер JDBC не поддерживает этот метод

С тех пор:

1.4

addConnectionEventListener

void addConnectionEventListener(ConnectionEventListener listener)

Регистрирует данного слушателя события так, чтобы это было уведомлено, когда событие будет иметь место на этом PooledConnection объект.

Параметры:

listener - компонент, обычно менеджер по пулу соединения, который реализовал ConnectionEventListener взаимодействуйте через интерфейс и хочет быть уведомленным, когда соединение закрывается или имеет ошибку

См. Также:

removeConnectionEventListener(javax.sql.ConnectionEventListener)

removeConnectionEventListener

void removeConnectionEventListener(ConnectionEventListener listener)

Удаляет данного слушателя события из списка компонентов, которые будут уведомлены, когда событие будет иметь место на этом PooledConnection объект.

Параметры:

listener - компонент, обычно менеджер по пулу соединения, который реализовал ConnectionEventListener взаимодействуйте через интерфейс и зарегистрированный в этом PooledConnection возразите как слушатель

См. Также:

addConnectionEventListener(javax.sql.ConnectionEventListener)

addStatementEventListener

void addStatementEventListener(StatementEventListener listener)

Регистры a StatementEventListener с этим PooledConnection объект. Компоненты, которые хотят быть уведомленными когда PreparedStatements создаваемый соединением закрываются или обнаруживаются, чтобы быть недопустимыми, может использовать этот метод, чтобы зарегистрировать a StatementEventListener с этим PooledConnection объект.

Параметры:

listener - компонент, который реализует StatementEventListener интерфейс, который должен быть зарегистрирован в этом PooledConnection объект

С тех пор:

1.6

removeStatementEventListener

void removeStatementEventListener(StatementEventListener listener)

Удаляет указанное StatementEventListener от списка компонентов, которые будут уведомлены, когда драйвер обнаружит это a PreparedStatement был закрыт или недопустим.

Параметры:

listener - компонент, который реализует StatementEventListener интерфейс, который был ранее зарегистрирован в этом PooledConnection объект

С тех пор:

1.6