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 ファイルとして追加する必要があります。Java™ JAR 依存関係エディターを使用して、依存関係を更新します。最良事例は、 下位互換性のために、EJB プロジェクトに対する参照を単に作成することです。 詳しくは、 『従属 JAR ファイルまたはモジュールの指定 』を参照してください。

EJB クライアント 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 として、 含まれるエンタープライズ・アプリケーションに追加されます。J2EE パースペクティブのプロジェクト・エクスプローラーに、EJB クライアント・プロジェクトが表示されます。 この EJB クライアント JAR ファイルへの参照は、 EJB プロジェクトがアプリケーションのモジュールとして定義されている限り、エンタープライズ・アプリケーションから除去できません。

重要: 「EJB JAR ファイルのエクスポート」ウィザードを使用して EJB プロジェクトをエクスポートする場合、このエクスポート・ウィザードには、EJB プロジェクトに関連した EJB クライアント JAR プロジェクトは含まれません。 EJB クライアント JAR ファイルを含めるには、EJB プロジェクトが含まれているエンタープライズ・アプリケーション EAR ファイルをエクスポートすることをお勧めします。その結果、EAR ファイルには依存 EJB クライアント JAR ファイルがユーティリティー JAR ファイルとして含まれます。 別の方法として、EJB プロジェクトをエクスポートする前に EJB クライアント JAR ファイルを除去するか、あるいは、 EJB クライアント JAR プロジェクトを別個に JAR ファイルとしてエクスポートすることもできます。チーム環境用の別のオプションとして、プロジェクトをまとめてエクスポートする方法もあります。 『共用対象プロジェクトのエクスポート』を参照してください。

関連タスク
EJB クライアント JAR プロジェクトの作成
EJB クライアント JAR プロジェクト の除去

フィードバック