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();