Интерфейс XAConnection

Все суперинтерфейсы:: PooledConnection

public interface XAConnection extends PooledConnection

Объект, обеспечивающий поддержку распределённых транзакций. Объект XAConnection может быть включён в распределённую транзакцию с помощью объекта XAResource. Менеджер транзакций, обычно являющийся частью сервера промежуточного уровня, управляет объектом XAConnection через объект XAResource.

Программист приложения не использует этот интерфейс напрямую; вместо этого его использует менеджер транзакций, работающий на сервере промежуточного уровня.

Начиная с:: 1.4

Краткое описание методов

Модификатор и тип	Метод	Описание
`XAResource`	`getXAResource()`	Возвращает объект `XAResource`, который менеджер транзакций будет использовать для управления участием объекта `XAConnection` в распределённой транзакции.

Методы, объявленные в интерфейсе PooledConnection

addConnectionEventListener, addStatementEventListener, close, getConnection, removeConnectionEventListener, removeStatementEventListener

Модификатор и тип	Метод	Описание
`void`	`addConnectionEventListener(ConnectionEventListener listener)`	Регистрирует указанный прослушиватель событий, чтобы он получал уведомления о возникновении события для этого объекта `PooledConnection`.
`void`	`addStatementEventListener(StatementEventListener listener)`	Регистрирует `StatementEventListener` в этом объекте `PooledConnection`.
`void`	`close()`	Закрывает физическое соединение, представленное этим объектом `PooledConnection`.
`Connection`	`getConnection()`	Создаёт и возвращает объект `Connection`, являющийся дескриптором физического соединения, представленного этим объектом `PooledConnection`.
`void`	`removeConnectionEventListener(ConnectionEventListener listener)`	Удаляет указанный прослушиватель событий из списка компонентов, которые будут получать уведомления о возникновении события для этого объекта `PooledConnection`.
`void`	`removeStatementEventListener(StatementEventListener listener)`	Удаляет указанный `StatementEventListener` из списка компонентов, которые будут получать уведомления, когда драйвер обнаружит, что `PreparedStatement` было закрыто или недействительно.

Подробное описание методов

getXAResource

XAResource getXAResource() throws SQLException

Возвращает объект XAResource, который менеджер транзакций будет использовать для управления участием объекта XAConnection в распределённой транзакции.

Возвращает:: объект XAResource
Вызывает исключение:: SQLException — если возникает ошибка доступа к базе данных; SQLFeatureNotSupportedException — если драйвер JDBC не поддерживает этот метод
Начиная с:: 1.4

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.