リソース参照の作成または変更

リソース参照のサポートにより、アプリケーションはランタイム環境で実際の名前ではなく、論理名を使用してリソース (データ・ソース、URL、またはメール・プロバイダーなど) にアクセスします。 この機能により、リソースのランタイム構成を変更する際にアプリケーション・コードを変更する必要がなくなります。

始める前に

このトピックでは、以前にアセンブルされたエンタープライズ・アプリケーションのリソース参照の更新について説明します。 プロシージャーのアセンブルについては、『アプリケーションのアセンブル』トピックで詳しく説明しています。

このタスクについて

リソース参照は、 アプリケーション・プロバイダーによりデプロイメント記述子で宣言されます。 アプリケーション・デプロイメント・プロセスのある時点で、 リソース参照を、 ランタイム環境のリソースの実際名にバインドする必要があります。 アプリケーション・サーバーで接続ファクトリーまたはデータ・ソースを作成する場合に、 アプリケーション・サーバーから提供される JNDI 名を使用すると、コンポーネントはこの接続ファクトリーまたはデータ・ソースにアクセスすることができます。 アプリケーション・サーバーは接頭部が java:comp/env の間接名を使用します。以下に例を示します。
  • データ・ソースを作成すると、デフォルトの JNDI 名が jdbc/data_source_name に設定されます。
  • 接続ファクトリーを作成すると、そのデフォルト名は eis/j2c_connection_factory_name になります。
ユーザー独自の名前を指定して、これらの値をオーバーライドする場合でも、 接頭部 java:comp/env を保持してください。 間接的な JNDI 名を使用すると、接続管理インフラストラクチャーは、アプリケーションに関連したリソース参照から任意のデータにアクセスすることができます。 これにより、認証、分離レベル、共有有効範囲、解決制御の設定に基づいて、リソースを効率的に管理できます。

このトピックでは、アセンブリー・ツールを使用して、エンタープライズ・アプリケーションのリソース参照を更新する方法について説明します。リソース参照を定義した後で、java:comp/env コンテキストを使用して JNDI 間接検索を実行することができます。

手順

  1. アセンブリー・ツールを開始します。
  2. Java Platform, Enterprise Edition (Java EE) モジュールで作業するためのアセンブリー・ツールの構成をまだ行っていない場合は、 ここで構成します。
  3. EJB プロジェクトに変更するエンタープライズ・アプリケーション (EAR ファイル) をインポートします。
  4. 次のようにして、モジュールのタイプのリソース参照を表示します。
    • エンタープライズ Bean がリソース参照を使用する場合:
      1. EAR ファイルの名前を展開します。
      2. EJB モジュール」を展開します。
      3. 該当する EJB モジュールを展開します。
      4. 該当するタイプのエンタープライズ Bean (セッション Bean また は エンティティー Bean) のセクションを展開します。
      5. エンタープライズ Bean を展開します。
    • サーブレットがリソース参照を使用する場合:
      1. EAR ファイルの名前を展開します。
      2. Web モジュール」を展開します。
      3. 該当する Web モジュールを展開します。
    • アプリケーション・クライアントがリソース参照を使用する場合:
      1. EAR ファイルの名前を展開します。
      2. アプリケーション・クライアント」を展開します。
      3. 該当するアプリケーション・クライアント・モジュールを展開します。
  5. リソース参照を変更するモジュールを右クリックして、 「Open With」>「Deployment Descriptor Editor」とクリックします。
  6. サーブレットおよびアプリケーション・クライアントの場合、「追加」をクリックします。EJB モジュールの場合、特定の Bean を選択して「追加」をクリックします。
  7. リソース参照オプションを選択して、「次へ」をクリックします。
  8. リソース参照の設定を指定して、「終了」をクリックします。
  9. オプション: References」タブを選択して、「WebSphere Extensions」の下で 分離レベルを選択します。 このステップをスキップする場合は、 分離レベルはデフォルトの TRANSACTION_NONE に設定されます。
  10. オプション: WebSphere Bindings」の下で、JNDI 名を指定します。 このステップをスキップする場合は、アプリケーションのデプロイ時に、 バインディングを設定 (またはオーバーライド) することができます。
  11. デプロイメント記述子エディターを閉じて、変更を保存します。

タスクの結果

更新済みモジュール用のファイルが、プロジェクト・エクスプローラー・ビューに表示されます。

次のタスク

プロジェクト・エクスプローラー・ビューで、更新したエンタープライズ・アプリケーションの内容を確認してください。 その後、エンタープライズ・アプリケーションをデプロイします。

EJB デプロイメント・コードの生成と 、ターゲット・サーバー への EJB モジュールのデプロイを、1 つのステップで行うことができます。プロジェクト・エクスプローラー・ビューで、EJB プロジェクトを 右クリックして、「デプロイ」をクリックしてください。 『EJB モジュールのデプロイ』トピックも参照してください。


トピックのタイプを示すアイコン タスク・トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=tatk_crtresref
ファイル名:tatk_crtresref.html