Bean 管理パーシスタンスを持つエンティティー Bean の作成

「エンタープライズ Bean の作成」ウィザードを使用すると、Bean 管理パーシスタンス (BMP) エンティティー Bean を作成できます。

このタスクについて

コンテナー管理パーシスタンス (CMP) を持つエンティティー Bean には、順序付け可能なデータを維持するコードがコンテナーに含まれているのに対して、 Bean 管理パーシスタンスを持つエンティティー Bean には、任意 のパーシスタンス・メカニズムのコードが含まれています。 例えば、パーシスタンスを管理するために必要な JDBC コードはすべて、 エンティティー Bean クラスまたはヘルパー・クラスで、手操作でコード化する必 要があります。

また、BMP エンティティー Bean は、データがデータベースではなくアプ リケーションに存在する場合に使用できます。 言い換えると、データ・ソースが、CMP エンティティー Bean によってサポートさ れていない場合に、BMP が代替となるような場合には、JDBC 以外の データベースやストアード・プロシージャーを使用することができます。

手順

  1. Java™ EE パースペクティブで、「ファイル」 > 「新規」 > 「その他」をクリックします。 「EJB」 > 「エンタープライズ Bean (1.x-2.x)」と選択して、「次へ」をクリックします。 あるいは、EJB プロジェクトを右クリックして、「新規」 > エンタープライズ Bean (1.x-2.x) をクリックします。
  2. 「Bean 管理パーシスタンス (BMP) フィールド付きのエンティティー Bean」を選択して「次へ」をクリックします。
  3. オプション: 新しい Bean が同じ EJB プロジェクト内の既存 Bean から継承するようにする場合は、Bean スーパータイプを選択します。 「Bean スーパータイプ」ドロップダウン・メニューは、他の BMP Bean が EJB プロジェクトに存在する場合に使用可能です。Bean スーパータイプを選択すると、キー・クラス・フィールドが使用不可になります。これは、サブタイプが、スーパータイプと同じキー・クラスを持つ必要があるためです。
  4. Bean を追加する「EJB プロジェクト」を選択します。
  5. Bean 名」フィールドに、エンタープライズ Bean に割り当てる名前を入力します。 規則により、Bean 名は大文字で始めます。
    注: Bean の名前にユニコード文字を使用できますが、ユニコード文字は、エンタープライズ Bean に関連付けられたエンタープライズ Bean のパッケージ、およびクラスではサポートされていません。
  6. 「ソース・フォルダー」フィールドで、新しい Bean 用のソース・フォルダーを選択します。
  7. 「デフォルト・パッケージ」フィールドに、新しい Bean 用のパッケージ名を入力します。
  8. オプション: EJB 2.x Bean の場合、「注釈付き Bean クラスの生成」を選択することもできます。 このオプションを選択すると、ウィザードはその Bean クラスの Java コードの先頭に注釈を生成します。 注釈は、ウィザードで指定したように Bean の実装を定義します。 この注釈は、EJB ツールが、必要な Bean クラスの生成および EJB デプロイメント記述子 (ejb-jar.xml) に挿入される値の提供に使用します。注釈を使い慣れており、デプロイメント記述子よりもむしろ注釈を利用して Bean を更新したい場合は、このオプションを選択してください。

    詳しくは、注釈ベース・プログラミングの概要を参照してください。

  9. 「次へ」をクリックします。
  10. 「Bean クラス」フィールドに、その Bean クラス用のパッケージおよびクラス名を入力します。 ウィザードでは、デフォルトで、Bean 名と定義したデフォルト・パッケージに基づいた Bean クラスを勧められます。 Bean クラスは、ウィザードが生成した新規クラス、またはプロジェクトのクラスパス内の既存のクラスでも構いません。「クラス」ボタンをクリックして、 Bean タイプに対応するプロジェクト内のクラスをリストするダイアログを開きます。 既存のクラスは、ソースを付けて Bean クラス名を青色で表示されます。 既存のバイナリー・クラスの Bean クラス名は、赤色で表示されます。
  11. クライアント・ビューとインターフェースを定義します。 EJB 2.0 以降の Bean の場合、リモート・クライアント・ビューまたはローカル・クライアント・ビュー、あるいはその両方を含めることができます。 EJB 1.1 Bean の場合は、リモート・クライアント・ビューのみがサポートされます。すべてのセッションまたはエンティティー Bean ごとに最低 1 つのクライアント・ビューが必要です。
    • リモート・クライアント・ビュー: セッション Bean 用にリモート・クライアント・ビューを組み込む場合は、このチェック・ボックスを選択します。

      「リモート・ホーム・インターフェース」および「リモート・インターフェース」フィールドには、リモート・クライアント・ビュー・インターフェース用に使用したいパッケージ名とクラス名を入力します。 ウィザードは、インターフェース・パッケージおよびクラス名の値として Bean 名とデフォルト・パッケージを推奨します。

    • ローカル・クライアント・ビュー: セッション Bean 用にローカル・クライアント・ビューを組み込む場合は、このチェック・ボックスを選択します。

      「ローカル・ホーム・インターフェース」および「ローカル・インターフェース」フィールドには、ローカル・クライアント・ビュー・インターフェース用に使用したいパッケージ名とクラス名を入力します。 ウィザードは、インターフェース・パッケージおよびクラス名の値として Bean 名とデフォルト・パッケージを推奨します。

  12. 「キー・クラス」フィールドに、そのエンティティー Bean のキー・クラス用のパッケージおよびクラス名を入力します。 デフォルトでは、ウィザードは、定義した Bean 名とパッケージ名に基づいたクラス名およびパッケージを推奨します。 Bean クラスは、ウィザードが生成した新規クラス、またはプロジェクトのクラスパス内の既存のクラスでも構いません。「クラス」ボタンをクリックして、 Bean タイプに対応するプロジェクト内のクラスをリストする「型の選択」ウィンドウを開きます。 既存のクラスは、ソースを付けて Bean クラス名を青色で表示されます。 既存のバイナリー・クラスの Bean クラス名は、赤色で表示されます。
  13. 「次へ」をクリックします。
  14. オプション: 「Bean スーパークラス」フィールドで、必要なスーパークラスを入力または選択します。
  15. オプション: リモートまたはローカル・クライアント・インターフェースにより拡張したいインターフェースを定義します。
    • 「追加」ボタンをクリックします。 すると、「型の選択」ウィンドウが開かれるので、そこで拡張するインターフェースを選択します。
    • 以前追加したインターフェースを今後は拡張する必要がない場合は、リストでそのインターフェースを選択して「削除」をクリックします。
    「次へ」をクリックします。
  16. オプション: Bean をクラス図に追加するには、このチェック・ボックスを選択し、プロジェクトのエクスプローラー・ビューからクラス図を選択します。 各 EJB プロジェクトには、既にデフォルトのクラス図が作成されています。新規のクラス図を作成したい場合は、「新規」をクリックして、「新規クラス図」ウィザードを開きます。
  17. 「終了」をクリックして、新しい Bean を指定された EJB プロジェクトに追加します。

フィードバック