リソース参照のサポートにより、アプリケーションはランタイム環境で実際の名前ではなく、論理名を使用してリソース (データ・ソース、URL、またはメール・プロバイダーなど) にアクセスします。
この機能により、リソースのランタイム構成を変更する際にアプリケーション・コードを変更する必要がなくなります。
始める前に
このトピックでは、以前にアセンブルされたエンタープライズ・アプリケーションのリソース参照の更新について説明します。
プロシージャーのアセンブルについては、『アプリケーションのアセンブル』トピックで詳しく説明しています。
このタスクについて
リソース参照は、
アプリケーション・プロバイダーによりデプロイメント記述子で宣言されます。
アプリケーション・デプロイメント・プロセスのある時点で、
リソース参照を、
ランタイム環境のリソースの実際名にバインドする必要があります。
アプリケーション・サーバーで接続ファクトリーまたはデータ・ソースを作成する場合に、
アプリケーション・サーバーから提供される JNDI 名を使用すると、コンポーネントはこの接続ファクトリーまたはデータ・ソースにアクセスすることができます。
アプリケーション・サーバーは接頭部が java:comp/env の間接名を使用します。以下に例を示します。
- データ・ソースを作成すると、デフォルトの JNDI 名が jdbc/data_source_name
に設定されます。
- 接続ファクトリーを作成すると、そのデフォルト名は eis/j2c_connection_factory_name になります。
ユーザー独自の名前を指定して、これらの値をオーバーライドする場合でも、
接頭部 java:comp/env を保持してください。
間接的な JNDI 名を使用すると、接続管理インフラストラクチャーは、アプリケーションに関連したリソース参照から任意のデータにアクセスすることができます。
これにより、認証、分離レベル、共有有効範囲、解決制御の設定に基づいて、リソースを効率的に管理できます。
このトピックでは、アセンブリー・ツールを使用して、エンタープライズ・アプリケーションのリソース参照を更新する方法について説明します。リソース参照を定義した後で、java:comp/env コンテキストを使用して JNDI 間接検索を実行することができます。
手順
- アセンブリー・ツールを開始します。
- Java Platform, Enterprise Edition (Java EE) モジュールで作業するためのアセンブリー・ツールの構成をまだ行っていない場合は、
ここで構成します。
- EJB プロジェクトに変更するエンタープライズ・アプリケーション (EAR ファイル) をインポートします。
- 次のようにして、モジュールのタイプのリソース参照を表示します。
- エンタープライズ Bean がリソース参照を使用する場合:
- EAR ファイルの名前を展開します。
- 「EJB モジュール」を展開します。
- 該当する EJB モジュールを展開します。
- 該当するタイプのエンタープライズ Bean (セッション Bean また
は エンティティー Bean) のセクションを展開します。
- エンタープライズ Bean を展開します。
- サーブレットがリソース参照を使用する場合:
- EAR ファイルの名前を展開します。
- 「Web モジュール」を展開します。
- 該当する Web モジュールを展開します。
- アプリケーション・クライアントがリソース参照を使用する場合:
- EAR ファイルの名前を展開します。
- 「アプリケーション・クライアント」を展開します。
- 該当するアプリケーション・クライアント・モジュールを展開します。
- リソース参照を変更するモジュールを右クリックして、
「Open With」>「Deployment Descriptor Editor」とクリックします。
- サーブレットおよびアプリケーション・クライアントの場合、「追加」をクリックします。EJB モジュールの場合、特定の Bean を選択して「追加」をクリックします。
- リソース参照オプションを選択して、「次へ」をクリックします。
- リソース参照の設定を指定して、「終了」をクリックします。
- オプション: 「References」タブを選択して、「WebSphere Extensions」の下で
分離レベルを選択します。 このステップをスキップする場合は、
分離レベルはデフォルトの TRANSACTION_NONE に設定されます。
- オプション: 「WebSphere Bindings」の下で、JNDI 名を指定します。 このステップをスキップする場合は、アプリケーションのデプロイ時に、
バインディングを設定 (またはオーバーライド) することができます。
- デプロイメント記述子エディターを閉じて、変更を保存します。
タスクの結果
更新済みモジュール用のファイルが、プロジェクト・エクスプローラー・ビューに表示されます。
次のタスク
プロジェクト・エクスプローラー・ビューで、更新したエンタープライズ・アプリケーションの内容を確認してください。
その後、エンタープライズ・アプリケーションをデプロイします。
EJB デプロイメント・コードの生成と
、ターゲット・サーバー
への EJB モジュールのデプロイを、1 つのステップで行うことができます。プロジェクト・エクスプローラー・ビューで、EJB プロジェクトを
右クリックして、「デプロイ」をクリックしてください。
『EJB モジュールのデプロイ』トピックも参照してください。