Интерфейс XADataSource

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

public interface XADataSource extends CommonDataSource

Фабрика объектов XAConnection, используемая внутри системы. Объект, реализующий интерфейс XADataSource, обычно регистрируется в службе именования, использующей интерфейс именования и каталогов Java (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` в качестве средства записи журнала.

Методы, объявленные в интерфейсе 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 средство записи журнала изначально равно null; иными словами, по умолчанию ведение журнала отключено.

Определено в:

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 время ожидания при входе изначально равно нулю.

Определено в:

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

Параметры:

seconds — ограничение времени ожидания при входе для источника данных

Выбрасывает:

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

Начиная с версии:

1.4

См. также:

getLoginTimeout

int getLoginTimeout() throws SQLException

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

Определено в:

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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/javax/sql/XADataSource.html