EJB クライアント JAR プロジェクト

EJB クライアント JAR プロジェクトには、クライアント・ プログラムが、EJB モジュール内に含まれているエンタープライズ Bean のクライアント・ビューを使用する のに必要なクラス・ファイルがすべて含まれます。

EJB ツールを使用して、EJB プロジェクトとそれに対応 する EJB クライアント JAR プロジェクトを作成できます。EJB プロジェクトは、 EJB クライアント JAR プロジェクトに依存します。 EJB クライアント JAR プロジェクトには、すべてのインターフェース・クラス、キー ・クラス、およびサポートするクラスなど、エンタープライズ Bean のクライアントに 必要なすべてのクラスが含まれます。これらのクラス は EJB プロジェクト内で重複しないため、EJB プロジェクトは EJB クライ アント JAR プロジェクトに依存します。EJB プロジェクト内のエンタープライズ Bean を 参照するプロジェクトはいずれも、EJB クライアント JAR プロジェクトへの参照を 必要とします。その EJB クライアント JAR プロジェクトが他のエンタープライズ ・アプリケーションにある場合、参照する EAR ファイルに、EJB クライアント JAR ファイル をユーティリティー JAR ファイルとして追加する必要があります。

EJB クライアント JAR プロジェクトを作成してから、 ホームまたはコンポーネント・インターフェースで必要な値オブジェクトを、このプロジェクトに自由に追加できます。 オブジェクトが存在しない場合、結果はコンパイル・エラーになります。

EJB クライアント JAR ファイル

EJB クライアント・プロジェクトは、 アプリケーションをエクスポートする時に EJB クライアント JAR ファイルとしてエクスポートされます。EJB ク ライアント JAR ファイルは、オプション の ejb-client-jar エレメントを使用して EJB JAR ファイルの デプロイメント記述子に指定します。 ejb-client-jar エレメントの値は、 含まれる J2EE エンタープライズ・アプリケーション・アーカイブ (.ear) ファイル内の EJB クライア ント JAR ファイルのロケーションを指定するパス名です。パス名の値は、 アプリケーション内の EJB JAR ファイルと相対的な URI です。
注: EJB クライアント JAR ファイルの相対 URI パスは、 EJB プロジェクトが属するすべてのアプリケーションで同一である必要があります。

EJB プロジェクトの EJB クライアント JAR プロジェクトを作成するとき、 EJB クライアント JAR ファイルが、プロジェクト・ユーティリティー JAR として、 含まれるエンタープライズ・アプリケーションに追加されます。この EJB クライアント JAR ファイルへの参照は、 EJB プロジェクトがアプリケーションのモジュールとして定義されている限り、エンタープライズ・アプリケーションから除去できません。

重要: 「EJB JAR ファイルのエクスポート」ウィザードを使用して EJB プロジェクトをエクスポートする場合、このエクスポート・ウィザードには、EJB プロジェクトに関連した EJB クライアント JAR プロジェクトは含まれません。 EJB クライアント JAR ファイルを含めるには、EJB プロジェクトが含まれているエンタープライズ・アプリケーション EAR ファイルをエクスポートすることをお勧めします。その結果、EAR ファイルに依存する EJB クライアント JAR ファイルがユーティリティー JAR ファイルとして含まれます。 別の方法として、EJB クライアント JAR プロジェクトを別個に JAR ファイルとしてエクスポートすることもできます。