5.4 UCPでの接続ラベルの適用

ラベルは、LabelableConnectionインタフェースのapplyConnectionLabelメソッドを使用して、流用された接続に適用されます。通常、このメソッドは、ラベリング・コールバックのconfigureメソッドからコールされます。任意の数の接続ラベルを流用された接続に累積的に適用できます。ラベルが接続に適用されるたびに、指定されたキー/値のペアが、すでに接続に適用されているラベルのコレクションに追加されます。最後に適用された値のみがどのキーに対しても保持されます。

注意:

流用された接続にラベルを適用するには、ラベリング・コールバックを接続プールに登録する必要があります。登録しないと例外がスローされます。

次の例では、トランザクション分離レベルで接続を初期化した後、ラベルを接続に適用しています。

String pname = "property1";
String pvalue = "value";
Connection conn = pds.getConnection();

// initialize the connection as required.

conn.setTransactionIsolation(Connection.TRANSACTION_SERIALIZABLE);

((LabelableConnection) conn).applyConnectionLabel(pname, pvalue);

特定のキーを適用済の接続ラベルのセットから削除するには、削除するキーおよびnull値のラベルを適用します。この方法は、接続ラベルのセットから特定のキー/値ペアを消去するために使用できます。