インターフェースへのメソッドのプロモート

リモート・インターフェースを直接編集しなくても、メソッドをエンタープライズ Bean クラスからリモート・インターフェースにプロモートできます。

このタスクについて

エンタープライズ Bean を作成する際、Bean に必要なメソッドのセットが自動的に作成されます。 これらの必要なメソッドを変更して、独自の新しいリモート (ビジネス) メソッドを追加することができます。

これらのリモート・メソッドを作成すると、リモート・インターフェースを直接編集しなくても、 そのメソッドをエンタープライズ Bean クラスからリモート・インターフェースにプロモートすることができます。 Bean クラスの API をリモート・インターフェースに公開するときは、性能について考慮する必要があります。 リモート・オブジェクト上のメソッドに対する数回の呼び出しは、パフォーマンスを低下させます。 いくつかの操作を単一のバッチ・メソッドに結合すると、パフォーマンスを改善できる場合があります。

他のメソッド・レベルの拡張機能は、デプロイメント記述子エディターの Bean ページで追加できます。

手順

  1. 以下の方法のいずれかで、Java™ エディターを開く。
    • Java EE パースペクティブの「エンタープライズ・エクスプローラー」ビューで、プロモートするメソッドを含んだ Bean クラスの Java ファイルを選択する。 「アプリケーションから開く」 > 「Java エディター」と選択する。
    • Java EE パースペクティブの「エンタープライズ・エクスプローラー」ビューで、ejbModule フォルダーと Bean クラスのパッケージを展開して、ご使用の Bean クラスの .java ファイルをダブルクリックする。
    • デプロイメント記述子エディターの Bean ページの「クラスおよびインターフェース・ファイル」セクションにおいて、 希望するクラスを選択し、「開く」をクリックする。
  2. Java EE パースペクティブの「アウトライン」ビューで、 プロモートしたいビジネス・メソッドを右クリックする。ポップアップ・メニューで、使用可能なインターフェースおよび作業対象の Bean の型により以下のオプションのいずれか 1 つを選択します。
    • 「エンタープライズ Bean (1.x-2.x)」 > 「ローカル・インターフェースへプロモートする」
    • 「エンタープライズ Bean (1.x-2.x)」 > 「ローカル・ホーム・インターフェースへプロモートする」
    • 「エンタープライズ Bean (1.x-2.x)」 > 「リモート・インターフェースへプロモートする」
    • 「エンタープライズ Bean (1.x-2.x)」 > 「ホーム・インターフェースへプロモートする」
    • 「エンタープライズ Bean (1.x-2.x)」 > 「サービス・エンドポイント・インターフェースへのプロモート」
    リモート・インターフェースへのプロモートを行った場合、生成されたプロモート・メソッドは、javax.ejb.RemoteException 例外をスローします。リモート・インターフェースが既に Java エディターで開かれている場合、ダーティーで表示されます。また、リモート・インターフェースを保持しているエディターが保存されるまで、Java エディターの「アウトライン」ビューでは、メソッドの横に「R」の印は付けられません。
  3. 変更内容を保存して、エディターを閉じる。

フィードバック