検索メソッドの定義
関連項目
検索メソッドは、EJB 2.1 エンティティー Bean で使用されるクエリーメソッドの一種です(選択メソッドは、もう 1 つのクエリーメソッドです)。検索メソッドはエンティティー Bean に固有のもので、エンティティー Bean は特定して見つかったデータベースのデータを表示します。セッション Bean はデータベースのデータを表さないため、検索できるデータがありません。
エンティティー Bean の検索メソッドを定義する
- ソースエディタで Bean クラスを開きます。
- ソースエディタ内を右クリックし、「EJB メソッド」>「検索メソッドを追加」を選択します。
- 「検索メソッドを追加」ダイアログで、メソッドシグニチャーを定義します。
- メソッドのベース名 findBy にテキストを追加します。
- メソッドの戻り値のカーディナリティを指定します。この設定は、データベースの文の戻り値のカーディナリティと一致する必要があります。「1」を選択した場合、文は Bean のインタフェースを返します。「多」を選択した場合、文は java.util.Collection オブジェクトを返します。
- Bean がコンテナ管理による持続性 (CMP) を使用する場合は、メソッドが返すエンタープライズ Bean を検索するためにメソッドが使用する EJB QL 文を入力します。
- メソッドを追加するインタフェースを指定します (リモートまたはローカル、あるいはその両方)。
- メソッドに必要なパラメータを指定します。
- 「了解」をクリックしてメソッドを作成します。
IDE は Bean のインタフェースにメソッドシグニチャーを追加し、汎用配備記述子にメソッドを登録します。
- エンティティー Bean が CMP を使用する場合は、これで終了です。コンテナがホームインタフェースまたはローカルホームインタフェースのシグニチャーから検索メソッドを実装するため、メソッドは、ホームインタフェースおよびローカルホームインタフェースにのみ現れます。
- エンティティー Bean が Bean 管理による持続性 (BMP) を使用する場合は、メソッドを実装できるように、IDE が空の ejbFindyourname メソッドを Bean クラスに追加します。ejbFindyourname メソッドは手動で実装する必要があります。
既存の検索メソッドを表示、編集、または削除する
- 「プロジェクト」ウィンドウで、EJB モジュールプロジェクトの「構成ファイル」ノードを展開します。
- ejb-jar.xml をダブルクリックします。ソースエディタ内にビジュアルエディタが表示されます。
- 「一般」ビューでエンティティー Bean ノードを展開し、「CMP 検索メソッド」ノードを展開します。既存のすべての CMP 検索メソッドが表に一覧表示されます。
- 「追加」または「編集」をクリックして、検索メソッドを変更します。
注:
- IDE がエンティティー Bean に検索メソッドを追加するとき、Bean クラスまたは Bean インタフェースは保存されません。プロジェクトをコンパイルまたは保存すると、変更がディスクに保存されます。
- 検索メソッドをエンタープライズ Bean から完全に削除するには、次のいずれかを行います。
- 「プロジェクト」ウィンドウで、Bean の「ローカルメソッド」ノード、「リモートメソッド」ノードまたは両方のノードからメソッドを削除する。
- ejb-jar.xml ビジュアルエディタで、「CMP 検索メソッド」からメソッドを削除する。
ソースエディタで検索メソッドを削除しても、Bean インタフェースからは削除されません。
- 関連項目
- エンティティー Bean について
- 選択メソッドの定義
- ビジネスメソッドの定義
- CMP フィールドの定義
- 検索メソッドまたは選択メソッドへの EJB QL の追加
- データベースからの CMP エンティティー Bean の生成
著作権と商標について