EJB QL を使用した finder メソッドの EJB Bean への追加

「find」または「ejbSelect」 finder メソッドを、EJB 2.x CMP Bean のホーム・インターフェースに追加できます。 finder メソッドは、EJB 照会言語を使用します。 ウィザードのガイドに従って各ステップを進み、新規または既存のファインダーを Bean に追加します。

このタスクについて

EJB 照会言語 (EJB QL) 構文は、SQL に基づいたもの で、エンタープライズ Bean の永続的属性および関連する Bean 属性を検索できます。照会言語は、リレーショナル・データ・ストアへの Bean のマッピングから独立しており、移植可能です。照会言語は、Bean のスキーマ・マッピングに基づくデプロイメント時に、SQL にコンパイルされます。

EJB QL のさらに詳しい情報が必要な場合は、WebSphere® Application Server インフォメーション・センターにアクセスして、 "EJB QL" というキーワードで検索してください。

手順

  1. Java™ EE パースペクティブの「エンタープライズ・エクスプローラー」ビューで、EJB プロジェクトのデプロイメント記述子を右クリックし、「アプリケーションから開く」 > 「デプロイメント記述子エディター」を選択します。
  2. エディターの「Bean」ページで、finder メソッドを追加する EJB 2.x CMP エンティティー Bean を選択します。
  3. 「照会」セクションで「追加」をクリックして、「ファインダー記述子の追加」ウィザードを開きます。
  4. 次のいずれかのオプションを選択します。
    • 「新規」- 新規 finder メソッドを作成します。
    • 「既存」- 既存 finder メソッドを使用します。
  5. 以下の選択項目の中からメソッド型を選択します。
    • 「find メソッド」- finder メソッドが、エンティティー Bean のホーム・インターフェース (ローカル、リモート、または両方) に定義されます。 finder メソッドは定義されている場所に応じて、戻りと結果が異なります。
    • 「ejbSelect メソッド」- ejbSelect メソッドは、 クライアント・ビューを介して直接には公開されることのない特殊な照会メソッドです。 ejbSelect メソッドは通常、エンティティーの永続的状態、 または照会が定義されているエンティティー Bean に関連するエンティティーを選択する場合に使用されます。
  6. 既存のファインダーを使用中の場合、検索されたファインダーのリストから選択し、「終了」をクリックして、ファインダー・メソッドを追加します。 新規ファインダーを定義している場合は、ステップ 7 から 15 までに進みます。
  7. ファインダーのタイプについては、以下のチェック・ボックスから少なくとも 1 つを選択します。
    • 「ローカル」- ローカル・メ ソッド呼び出し用のローカル・ホーム・インターフェースに、メソッド宣言 を追加することを選択します。
    • 「リモート」- リモート・メ ソッド呼び出し用のリモート・ホーム・インターフェースに、メソッド宣言 を追加することを選択します。
    両方のチェック・ボックスを選択して、リモートおよびローカル・ インターフェースの両方にファインダーを組み込むこともできます。 チェック・ボックスが選択可能なのは、Bean にそれぞれのインターフェースが組み込まれている場合のみです。
  8. オプション: ejbSelect メソッドを作成している場合は、「戻りリモート・エンティティー」チェック・ボックスを選択できます。 このオプションは、リモート参照を戻すようユーザーが要求したことを示します。 このオプションは、このメソッド型でのみ使用できます。
  9. 「名前」フィールドに、新しい照会の名前を入力します。 照会メソッド名は、find または ejbSelect のように、 選択した型を示す文字から始めてください。
  10. オプション: 「追加」をクリックしてメソッド・パラメーターを追加します。
  11. 「戻りの型」ドロップダウン・リストで、finder メソッドが返す型を選択します。 「次へ」をクリックします。
  12. オプション: 「記述」テキスト域に、メソッドの記述を入力します。
  13. オプション: EJB 照会の生成を容易にするために、「サンプル照会の選択」ドロップダウン・リストのサンプル照会から開始することができます。
  14. 「照会ステートメント」テキスト域に、照会を入力または変更します。
  15. 「終了」をクリックします。

タスクの結果

<query></query> 要素が Bean の デプロイメント記述子に追加されます。 実際の照会は<ejb-ql></ejb-ql> 要素に追加されます。 メソッド宣言がホーム・インターフェース (ユーザーの選択により、ローカル、リモート、または両方) に追加されます。

次のタスク

照会を編集または削除するには、 「照会」セクションで照会を選択して「編集」または「削除」をクリックします。

フィードバック