Интерфейс 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, записыватель журнала изначально равен 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, таймаут входа составляет 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, 2023, 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/21/docs/api/java.sql/javax/sql/XADataSource.html