Bean へのクライアント・ビューまたはインターフェースの追加

EJB デプロイメント記述子エディターを使用して、 既存のエンティティーまたはセッション Bean に、 クライアント・ビューあるいはインターフェースを追加したり、 そこから削除したりすることができます。

このタスクについて

クライアント・ビューはローカル、またはリモートのいずれかであり、 エンティティー Bean およびセッション Bean には少なくとも 1 つのクライアント・ビューが組み込まれている必要があります。 EJB 2.x Bean には、ローカルおよびリモートのクライアント・ビューを組み込むことができますが、EJB 1.1 Bean には、デフォルトのリモート・クライアント・ビューのみを組み込むことができます。 メッセージ駆動型 Bean にはクライアント・インターフェースがありません。 EJB 2.1 ステートレス・セッション Bean にも Web サービス・クライアント・ビューを含めることができます。

例えば、既存の EJB 2.0 BMP エンティティー Bean にローカルおよびローカル・ホーム・インターフェース (ローカル・クライアント・ビュー) が組み込まれている場合は、 デプロイメント記述子エディターを使用して、リモートおよびリモート・ホーム・インターフェースを追加できます。 このインターフェースを追加する場合には、 既存のローカル・インターフェースから新規リモート・インターフェースにメソッドをコピーするオプションがあります。 さらに、リモート・インターフェースの追加と同様に、 既存のローカル・インターフェースを同時に削除することも選択できます。

EJB 1.1 Bean には、リモート・インターフェースのみ組み込まれていますので、 クライアント・ビューを追加すること、または EJB 1.1 Bean から既存のクライアント・ビューを削除することはできません。

手順

  1. Java™ EE パースペクティブの「エンタープライズ・エクスプローラー」ビューで、EJB プロジェクトのデプロイメント記述子を右クリックし、「アプリケーションから開く」 > 「デプロイメント記述子エディター」を選択します。
  2. エディターの Bean ページで、作業する Entity または Session Bean を選択します。
  3. 「クラスおよびインターフェース・ファイル」セクションで、「追加」をクリックします。
  4. 「新規インターフェースの追加」セクションのチェック・ボックスを選択して、追加するクライアント・ビューのタイプを指定します。 存在しているインターフェースに対応して、該当するチェック・ボックスのみが使用可能になります。
  5. 「既存のインターフェースから新規クライアント・ビューにメソッドを追加」セクションで、既存のインターフェースからメソッドをコピーするかどうかを選択します。 このオプションは、既存のインターフェースがない場合は使用できません。 「次へ」をクリックします。
  6. それぞれのインターフェースに対して、対象のパッケージ、およびクラスを選択します。
  7. 「終了」をクリックします。

次のタスク

Bean に特定のクライアント・ビューは必要ないと判断した場合、そのクライアント・ビューが必須でなければ Bean から削除できます。クライアント・ビューを追加した後に削除するには、「クラスおよびインターフェース・ファイル」セクションでそのクライアント・ビューを選択して「削除」をクリックします。「クライアント・ビューの削除」ウィザードが、削除を完了させるのに役立ちます。

フィードバック