Интерфейс ConnectionBuilder

public interface ConnectionBuilder

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

Следующий пример демонстрирует использование ConnectionBuilder для создания Connection:


     DataSource ds = new MyDataSource();
     ShardingKey superShardingKey = ds.createShardingKeyBuilder()
                           .subkey("EASTERN_REGION", JDBCType.VARCHAR)
                           .build();
     ShardingKey shardingKey = ds.createShardingKeyBuilder()
                           .subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
                           .build();
     Connection con = ds.createConnectionBuilder()
                       .user("rafa")
                       .password("tennis")
                       .shardingKey(shardingKey)
                       .superShardingKey(superShardingKey)
                       .build();

Since:: 9

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

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

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

user

ConnectionBuilder user(String username)

Устанавливает имя пользователя, которое будет использовано при создании соединения.

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

password

ConnectionBuilder password(String password)

Устанавливает пароль, который будет использован при создании соединения.

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

shardingKey

ConnectionBuilder shardingKey(ShardingKey shardingKey)

Устанавливает shardingKey, который будет использован при создании соединения.

Параметры:

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

Возвращает:

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

См. также:

superShardingKey

ConnectionBuilder superShardingKey(ShardingKey superShardingKey)

Устанавливает superShardingKey, который будет использован при создании соединения.

Параметры:

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

Возвращает:

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

См. также:

build

Connection 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/java/sql/ConnectionBuilder.html