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

Since:: 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://download.java.net/java/early_access/jdk24/docs/api/java.sql/javax/sql/XAConnectionBuilder.html