モジュール 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")
                       .setShardingKey(shardingKey)
                       .setSuperShardingKey(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インスタンス
        関連項目:
        ShardingKey, ShardingKeyBuilder

      • superShardingKey

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

      • build

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