モジュール java.sql
パッケージ java.sql

インタフェース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

  • メソッドの詳細

    • 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インスタンス
      関連項目:
      ShardingKey, ShardingKeyBuilder

    • superShardingKey

      ConnectionBuilder superShardingKey​(ShardingKey superShardingKey)
      接続を作成するときに使用するsuperShardingKeyを指定
      パラメータ:
      superShardingKey - SuperShardingKey。 nullも可
      戻り値:
      同じConnectionBuilderインスタンス
      関連項目:
      ShardingKey, ShardingKeyBuilder

    • build

      Connection build() throws SQLException
      このBuilderによって定義されたオブジェクトのインスタンスを返します。
      戻り値:
      構築されたオブジェクト
      例外:
      SQLException - オブジェクトの構築中にエラーが発生した場合