Интерфейс XADataSource

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

public interface XADataSource extends CommonDataSource

Фабрика для XAConnection объектов, используемая внутри. Объект, реализующий интерфейс XADataSource, обычно регистрируется в службе именования, которая использует Java Naming and Directory Interface (JNDI).

Реализация интерфейса XADataSource должна включать публичный конструктор без аргументов.

С момента:: 1.4

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

Модификатор и тип	Метод	Описание
`default XAConnectionBuilder`	`createXAConnectionBuilder()`	Создает новый `XAConnectionBuilder` экземпляр
`int`	`getLoginTimeout()`	Возвращает максимальное время в секундах, которое этот источник данных может ожидать, пытаясь подключиться к базе данных.
`PrintWriter`	`getLogWriter()`	Возвращает объект записывателя журнала для этого объекта `DataSource`.
`XAConnection`	`getXAConnection()`	Попытка установить физическое подключение к базе данных, которое может быть использовано в распределённой транзакции.
`XAConnection`	`getXAConnection(String user, String password)`	Попытка установить физическое подключение к базе данных, используя заданное имя пользователя и пароль.
`void`	`setLoginTimeout(int seconds)`	Устанавливает максимальное время в секундах, которое этот источник данных будет ожидать при попытке подключения к базе данных.
`void`	`setLogWriter(PrintWriter out)`	Устанавливает объект записывателя журнала для этого объекта `DataSource` на заданный объект `java.io.PrintWriter`.

Методы, объявленные в интерфейсе javax.sql.CommonDataSource

createShardingKeyBuilder, getParentLogger

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

getXAConnection

XAConnection getXAConnection() throws SQLException

Попытка установить физическое подключение к базе данных, которое может быть использовано в распределённой транзакции.

Возвращает:: объект XAConnection, представляющий физическое подключение к источнику данных, которое может быть использовано в распределённой транзакции
Бросает:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод; SQLTimeoutException - когда драйвер определил, что значение таймаута, указанное методом setLoginTimeout, было превышено, и по крайней мере попытался отменить текущую попытку подключения к базе данных
С момента:: 1.4

getXAConnection

XAConnection getXAConnection(String user, String password) throws SQLException

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

Параметры:: user - пользователь базы данных, от имени которого создается подключение; password - пароль пользователя
Возвращает:: объект XAConnection, представляющий физическое подключение к источнику данных, которое может быть использовано в распределённой транзакции
Бросает:: SQLException - если произошла ошибка доступа к базе данных; SQLFeatureNotSupportedException - если JDBC драйвер не поддерживает этот метод; SQLTimeoutException - когда драйвер определил, что значение таймаута, указанное методом setLoginTimeout, было превышено, и по крайней мере попытался отменить текущую попытку подключения к базе данных
С момента:: 1.4

getLogWriter

PrintWriter getLogWriter() throws SQLException

Возвращает объект записывателя журнала для этого объекта DataSource.

Записывателя журнала — это символьный поток вывода, в который будут выводиться все сообщения регистрации и отслеживания для этого источника данных. Сюда входят сообщения, выводимые методами этого объекта, сообщения, выводимые методами других объектов, созданных этим объектом, и т. д. Сообщения, выводимые в специфический для источника данных записыватель журнала, не выводятся в записыватель журнала, связанный с классом java.sql.DriverManager. Когда создается объект DataSource, записывателя журнала изначально нет; другими словами, по умолчанию регистрация отключена.

Указано в:

getLogWriter в интерфейсе CommonDataSource

Возвращает:

записыватель журнала для этого источника данных или null, если регистрация отключена

Бросает:

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

С момента:

1.4

См. также:

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

Устанавливает объект записывателя журнала для этого объекта DataSource на заданный объект java.io.PrintWriter.

Указано в:

setLogWriter в интерфейсе CommonDataSource

Параметры:

out - новый записыватель журнала; для отключения регистрации установите значение null

Бросает:

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

С момента:

1.4

См. также:

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

Устанавливает максимальное время в секундах, которое этот источник данных будет ожидать при попытке подключения к базе данных. Значение 0 указывает, что таймаут равен системному таймауту по умолчанию, если он существует; в противном случае, это указывает, что таймаута нет. Когда создаётся объект DataSource, таймаут входа в систему изначально равен 0.

Указано в:

setLoginTimeout в интерфейсе CommonDataSource

Параметры:

seconds - лимит времени входа в систему источника данных

Бросает:

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

С момента:

1.4

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

Возвращает максимальное время в секундах, которое этот источник данных может ожидать, пытаясь подключиться к базе данных. Значение 0 означает, что таймаут равен системному таймауту по умолчанию, если он существует; в противном случае, это означает, что таймаута нет. Когда создаётся объект DataSource, таймаут входа в систему изначально равен 0.

Указано в:

getLoginTimeout в интерфейсе CommonDataSource

Возвращает:

предел времени входа в систему источника данных

Бросает:

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

С момента:

1.4

См. также:

createXAConnectionBuilder

default XAConnectionBuilder createXAConnectionBuilder() throws SQLException

Создает новый XAConnectionBuilder экземпляр

Требования к реализации:

Реализация по умолчанию бросит исключение SQLFeatureNotSupportedException.

Возвращает:

Экземпляр XAConnectionBuilder, который был создан

Бросает:

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

SQLFeatureNotSupportedException - если драйвер не поддерживает фрагментацию

С момента:

См. также:

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/XADataSource.html