Интерфейс 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`.

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

createShardingKeyBuilder, getParentLogger

Модификатор и тип	Метод	Описание
`default ShardingKeyBuilder`	`createShardingKeyBuilder()`	Создает новый экземпляр `ShardingKeyBuilder`
`Logger`	`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.