Module java.sql
Package javax.sql

Interface XAConnectionBuilder

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

  • Method Details

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