3.16.6　コネクション定義の複数指定

(a)　DDでの指定個所とコネクション定義に指定できる要素

コネクション定義は，Connector 1.5仕様に対応したDDの，<connection-definition>下に指定します。<connection-definition>の下に指定する要素を次に示します。

• <managedconnectionfactory-class>

• <config-property>

• <connectionfactory-interface>

• <connectionfactory-impl-class>

• <connection-interface>

• <connection-impl-class>

(b)　Connector属性ファイルの階層構造とコネクション定義の対応

DD（ra.xml）の階層構造の変更に合わせて，属性ファイルにもコネクション定義に対応する階層が追加されます。

J2EEサーバにインポート済みのリソースアダプタの場合，リソースアダプタのプロパティの変更には，Connector属性ファイルを使用します。Connector属性ファイルに定義した値は，サーバ管理コマンドを使用してJ2EEサーバ上のリソースアダプタに反映します。属性ファイルによるプロパティの設定手順については，マニュアル「アプリケーションサーバ アプリケーション設定操作ガイド」の「3.5　属性ファイルによるプロパティの設定」を参照してください。

なお，リソースアダプタの動作に関連するプロパティには，コネクション定義ごとに定義する項目と，リソースアダプタ全体に定義する項目があります。コネクション定義ごとに指定する項目については，Connector属性ファイルの<outbound-resourceadapter>-<connection-definition>下に指定します。リソースアダプタ全体に対して指定する項目については，<resourceadapter-runtime>-<property>下に指定します。

指定方法の詳細については，マニュアル「アプリケーションサーバ リファレンス 定義編(アプリケーション／リソース定義)」の「4.1.1　Connector属性ファイルの指定内容」を参照してください。

(c)　J2EEアプリケーションでのリンク解決の定義方法（<resource-ref>-<linked-to>，<cmp-map>-<datasource-name>またはmappedNameでの指定方法）

Connector 1.5仕様に準拠したリソースアダプタを参照するJ2EEアプリケーションでは，リンク解決のために，J2EEアプリケーションがどのコネクション定義を参照するかを定義する必要があります。

定義は，次のどれかの方法で指定します。

• J2EEアプリケーションの属性ファイル（WAR属性ファイル，Session Bean属性ファイル，Entity Bean属性ファイルまたはMessageDrivenBean属性ファイル）の<resource-ref>-<linked-to>

• J2EEアプリケーションの属性ファイル（Entity Bean属性ファイル）の<cmp-map>-<datasource-name>

• アノテーション@ResourceのmappedName属性

  注意事項

  参照先のリソースがConnector 1.5仕様に準拠したリソースアダプタの場合は，必ずコネクション定義識別子を指定してください。指定を省略した場合，リンク解決に失敗します。また，参照先のリソースがConnector 1.0仕様に準拠したリソースアダプタの場合は，コネクション定義識別子を指定しないでください。指定した場合，リンク解決に失敗します。

コネクション定義識別子を含む参照先のリソースは，次の形式で指定します。

<リソースアダプタの表示名>!<コネクション定義識別子>

指定内容について説明します。

<リソースアダプタの表示名>

参照先のリソースアダプタのDD（ra.xml）の<connector>-<display-name>要素の値です。

<コネクション定義識別子>

参照先のリソースアダプタのDD（ra.xml）の<connector>-<resourceadapter>-<outbound-resourceadapter>-<connection-definition>-<connectionfactory-interface>要素の値です。

なお，リソースアダプタの表示名およびコネクション定義識別子は，次のサーバ管理コマンドでも確認できます。

• cjlistappコマンド（アプリケーションに含まれるRARファイルの場合）

• cjlistresコマンド

• cjlistrarコマンド

(a)　コネクションプールを対象にしたコマンドの実行

コネクションプールを対象にしたサーバ管理コマンドを実行するときには，どのコネクションプールを対象にするかを指定する必要があります。

次のコマンドを実行する場合には，コネクション定義識別子の指定が必要です。コネクション定義識別子は，これらのコマンドのオプションで指定します。

• cjclearpoolコマンド

  詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjclearpool（コネクションプール内のコネクション削除）」を参照してください。

• cjlistpoolコマンド

  詳細については，マニュアル「アプリケーションサーバ リファレンス コマンド編」の「cjlistpool（コネクションプールの一覧表示）」を参照してください。

(b)　コネクションプールのウォーミングアップ処理

コネクションプールのウォーミングアップ処理は，コネクション定義ごとに実行されます。

コネクションプールのウォーミングアップ処理が実行される場合に，特定のコネクション定義に対応するコネクションプールのウォーミングアップに失敗しても，それ以外のコネクションプールに対するウォーミングアップ処理は継続されます。