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

Начиная с:: 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://docs.oracle.com/en/java/javase/25/docs/api/java.sql/java/sql/ConnectionBuilder.html