Module java.sql
Package java.sql

Interface ConnectionBuilder

public interface ConnectionBuilder
从DataSource对象创建的构建器，用于建立与数据源对象表示的数据库的连接。为数据源指定的连接属性将作为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

  • Method Details

    • 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 - 如果构建对象时发生错误