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

См. также:

CommonDataSource.setLogWriter(java.io.PrintWriter)

setLogWriter

void setLogWriter(PrintWriter out) throws SQLException

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

Унаследовано от:

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

Параметры:

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

Исключения:

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

С:

1.4

См. также:

CommonDataSource.getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds) throws SQLException

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

Унаследовано от:

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

Параметры:

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

Исключения:

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

С:

1.4

См. также:

CommonDataSource.getLoginTimeout()

getLoginTimeout

int getLoginTimeout() throws SQLException

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

Унаследовано от:

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

Возвращает:

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

Исключения:

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

С:

1.4

См. также:

CommonDataSource.setLoginTimeout(int)

createXAConnectionBuilder

default XAConnectionBuilder createXAConnectionBuilder() throws SQLException

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

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

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

Возвращает:

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

Исключения:

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

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

С:

См. также:

XAConnectionBuilder

© 1993, 2021, 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/17/docs/api/java.sql/javax/sql/XADataSource.html