Интерфейс XAConnectionBuilder

public interface XAConnectionBuilder

Построитель, созданный на основе объекта XADataSource и используемый для установления соединения с базой данных, которую представляет объект data source. Свойства соединения, указанные для data source, используются построителем XAConnectionBuilder в качестве значений по умолчанию.

В следующем примере показано использование XAConnectionBuilder для создания XAConnection:

    XADataSource ds = new MyXADataSource();
    ShardingKey superShardingKey = ds.createShardingKeyBuilder()
                          .subkey("EASTERN_REGION", JDBCType.VARCHAR)
                          .build();
    ShardingKey shardingKey = ds.createShardingKeyBuilder()
                          .subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
                          .build();
    XAConnection con = ds.createXAConnectionBuilder()
                      .user("rafa")
                      .password("tennis")
                      .shardingKey(shardingKey)
                      .superShardingKey(superShardingKey)
                      .build();

Начиная с:: 9

Краткое описание методов

Модификатор и тип	Метод	Описание
`XAConnection`	`build()`	Возвращает экземпляр объекта, определённого этим построителем.
`XAConnectionBuilder`	`password(String password)`	Задаёт пароль, используемый при создании соединения
`XAConnectionBuilder`	`shardingKey(ShardingKey shardingKey)`	Задаёт `shardingKey`, используемый при создании соединения
`XAConnectionBuilder`	`superShardingKey(ShardingKey superShardingKey)`	Задаёт `superShardingKey`, используемый при создании соединения
`XAConnectionBuilder`	`user(String username)`	Задаёт имя пользователя, используемое при создании соединения

Подробное описание методов

user

XAConnectionBuilder user(String username)

Задаёт имя пользователя, используемое при создании соединения

Параметры:: username — пользователь базы данных, от имени которого устанавливается соединение
Возвращает:: тот же экземпляр XAConnectionBuilder

password

XAConnectionBuilder password(String password)

Задаёт пароль, используемый при создании соединения

Параметры:: password — пароль для этого соединения. Может быть null
Возвращает:: тот же экземпляр XAConnectionBuilder

shardingKey

XAConnectionBuilder shardingKey(ShardingKey shardingKey)

Задаёт shardingKey, используемый при создании соединения

Параметры:

shardingKey — ShardingKey. Может быть null

Возвращает:

тот же экземпляр XAConnectionBuilder

См. также:

superShardingKey

XAConnectionBuilder superShardingKey(ShardingKey superShardingKey)

Задаёт superShardingKey, используемый при создании соединения

Параметры:

superShardingKey — SuperShardingKey. Может быть null

Возвращает:

тот же экземпляр XAConnectionBuilder

См. также:

build

XAConnection build() throws SQLException

Возвращает экземпляр объекта, определённого этим построителем.

Возвращает:: Созданный объект
Выбрасывает:: SQLException — если при создании объекта возникает ошибка

© 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/XAConnectionBuilder.html