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 ファセットを追加するときに、このファイルは作成されません。このファイルを生成するには、プロジェクトを右クリックして、メニューからを選択します。
手順
- Context and Dependency Injection デプロイメント記述子エディターを開くには、beans.xml ファイルをダブルクリックします。
- 「追加」をクリックして、代替、デコレーター、およびインターセプターを beans.xml ファイルに追加します。
CDI 1.2 以降では、「追加」をクリックして、除外フィルターを設定するために使用できる scan を指定することもできます。除外フィルターは、クラスが Bean としてディスカバーされないようにします。
- CDI 1.2 のエディターでは、Bean アーカイブをスキャンする方法を指定するために、bean-discovery-mode 値として all、annotated、または none を使用します。
CDI デプロイメント記述子エディターは、以下の状態では検証エラーを発行します。
- 空の代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
- 存在しない代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
- 重複した代替クラス、デコレーター・クラス、インターセプター・クラスがある場合。
- 適切な @Alternative、@Interceptor、または @Decorator の注釈が指定されていないクラスがある場合。