11.4 データベース・シャーディングのサポート用UCP API
UCPConnectionビルダー・クラス
UCPConnectionBuilder
クラスは、username
、password
およびlabel
以外の追加パラメータで接続オブジェクトを作成するために使用されます。ビルダーを使用するには、接続リクエストの一部である必要がある各パラメータの対応するビルダー・メソッド、build
メソッドの順にコールする必要があります。ビルダー・メソッドをコールする順序は重要ではありません。ただし、同じビルダー属性を複数回適用する場合、最新の値のみが接続の作成時に考慮されます。
構文
public abstract class UCPConnectionBuilder<S> implements OracleConnectionBuilder<UCPConnectionBuilder<S>,S>
UCPConnectionBuilder
クラスは、validate
メソッドおよび特定のユーザーのデータを設定するための複数のコンストラクタも提供します。
例11-2 接続ビルダーの作成
PoolDataSource pds = PoolDataSourceFactory.getPoolDataSource();
..//set the required properties on the datasource
ShardingKey superShardingKey = ds.createShardingKeyBuilder()
.subkey("EASTERN_REGION", JDBCType.VARCHAR)
.build();
ShardingKey superShardingKey = ds.createShardingKeyBuilder()
.subkey("PITTSBURGH_BRANCH", JDBCType.VARCHAR)
.build();
Connection conn = pds.createConnectionBuilder()
.shardingKey(superShardingKey)
.superShardingKey(superShardingKey)
.build();
PoolDataSourceインタフェースの新しいメソッド
次のメソッドがoracle.ucp.jdbc.PoolDataSource
インタフェースで導入されました。
/**
* Creates a new UCPConnectionBuilder instance.
*
* @param <S>
* Connection type for this ConnectionBuilder
* @param <B>
* Builder type to use
* @return The OracleConnectionBuilder instance that was created
*/
public UCPConnectionBuilder createConnectionBuilder();
/**
* Creates a new OracleShardingKeyBuilder instance
*
* @return The OracleShardingKeyBuilder instance that was created
*/
public default OracleShardingKeyBuilder createShardingKeyBuilder() {
return new OracleShardingKeyBuilderImpl();
}
PoolXADataSourceインタフェースの新しいメソッド
次のメソッドがoracle.ucp.admin.UniversalConnectionPoolManager
インタフェースで導入されました。
/**
* Creates a new XAConnectionBuilder instance.
*
* @return The XAConnectionBuilder instance that was created
*/
public UCPXAConnectionBuilder createXAConnectionBuilder();