Context and Dependency Injection プロジェクトの編集および検証

Context and Dependency Injection デプロイメント記述子エディターを使用して、beans.xml ファイルを編集および検証できます。

始める前に

ワークスペースで Java™ EE ファセット・プロジェクト (すなわち、ユーティリティー・プロジェクト、EJB プロジェクト、Web プロジェクト、コネクター・プロジェクト、またはアプリケーション・クライアント・プロジェクト) を作成します。これらのプロジェクトのいずれかを作成する方法については、ウィザードを使用した Java EE プロジェクトの作成と構成を参照してください。

このタスクについて

CDI 1.0 では、CDI 対応プロジェクトのパッケージ化およびデプロイメントには beans.xml ファイルが必要です。beans.xml ファイルの存在によって、デプロイされるモジュールが Bean アーカイブであることをコンテナーに指示します。CDI ファセットをインストールすると、デプロイメント記述子が生成されます。Contexts and Dependency Injection (CDI) を使用するアプリケーションの作成を参照してください。当初、beans.xml ファイルは空です。すなわち、モジュール内に存在する注釈付きのインターセプター、デコレーター、および代替はすべて無効になります。これらのクラスを有効にするために、CDI デプロイメント記述子エディターを使用してそれらを構成できます。

CDI 1.2 以降では、CDI 対応プロジェクトのパッケージ化およびデプロイメントのための beans.xml ファイルはオプションです。CDI 1.2 ファセットを追加するときに、このファイルは作成されません。このファイルを生成するには、プロジェクトを右クリックして、メニューから「Java EE ツール」 > 「CDI Bean デプロイメント記述子スタブの生成 (Generate CDI Beans Deployment Descriptor Stub)」を選択します。

手順

  1. Context and Dependency Injection デプロイメント記述子エディターを開くには、beans.xml ファイルをダブルクリックします。
  2. 「追加」をクリックして、代替、デコレーター、およびインターセプターを beans.xml ファイルに追加します。

    CDI 1.2 以降では、「追加」をクリックして、除外フィルターを設定するために使用できる scan を指定することもできます。除外フィルターは、クラスが Bean としてディスカバーされないようにします。

  3. CDI 1.2 のエディターでは、Bean アーカイブをスキャンする方法を指定するために、bean-discovery-mode 値として all、annotated、または none を使用します。

    CDI デプロイメント記述子エディターは、以下の状態では検証エラーを発行します。

    • 空の代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
    • 存在しない代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
    • 重複した代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
    • 適切な @Alternative、@Interceptor、または @Decorator の注釈が指定されていないクラスがある場合。
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tcdideploymentdescriptoreditor.html