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

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

導入されたバージョン:
9

  • メソッドの詳細

    • 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 - オブジェクトの構築中にエラーが発生した場合