Интерфейс XADataSource

Все суперинтерфейсы:
CommonDataSource
public interface XADataSource
extends CommonDataSource

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

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

С:
1.4

Методы

Модификатор и типМетодОписание
default XAConnectionBuildercreateXAConnectionBuilder()

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

intgetLoginTimeout()

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

PrintWritergetLogWriter()

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

XAConnectiongetXAConnection()

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

XAConnectiongetXAConnection​(String user, String password)

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

voidsetLoginTimeout​(int seconds)

Устанавливает максимальное время в секундах, которое этот источник данных будет ожидать при попытке подключения к базе данных.

voidsetLogWriter​(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.

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

Задано в:
setLogWriter в интерфейсе CommonDataSource
Параметры:
out - новый записыватель журнала; для отключения регистрации, установите в значение null
Исключения:
SQLException - если произошла ошибка доступа к базе данных
С:
1.4
См. также:
CommonDataSource.getLogWriter()

setLoginTimeout

void setLoginTimeout(int seconds)
              throws SQLException

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

Задано в:
setLoginTimeout в интерфейсе CommonDataSource
Параметры:
seconds - лимит времени входа в систему источника данных
Исключения:
SQLException - если произошла ошибка доступа к базе данных.
С:
1.4
См. также:
CommonDataSource.getLoginTimeout()

getLoginTimeout

int getLoginTimeout()
             throws SQLException

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

Задано в:
getLoginTimeout в интерфейсе CommonDataSource
Возвращает:
лимит времени входа в систему источника данных
Исключения:
SQLException - если произошла ошибка доступа к базе данных.
С:
1.4
См. также:
CommonDataSource.setLoginTimeout(int)

createXAConnectionBuilder

default XAConnectionBuilder createXAConnectionBuilder()
                                               throws SQLException

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

Требования к реализации:
Реализация по умолчанию выбросит исключение SQLFeatureNotSupportedException.
Возвращает:
Экземпляр XAConnectionBuilder, который был создан
Исключения:
SQLException - если при создании билдера произошла ошибка
SQLFeatureNotSupportedException - если драйвер не поддерживает фрагментацию
С:
9
См. также:
XAConnectionBuilder

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

Spec-Zone .ru
спецификации, руководства, описания, API