セッション Bean ファサードの作成

CMP エンティティー Bean のためのセッション・ウィザードおよび関連の静的 SDO を作成するには、 「セッション Bean ファサードの作成」ウィザードを使用します。

始める前に

重要:
  • セッション Bean ファサードの生成は、WebSphere® Application Server v6.x をターゲットとする EJB プロジェクト内の EJB 2.x CMP エンティティー Bean の場合のみサポートされます。プロジェクト・プロパティー内のターゲット・サーバーは変更することができます。 ウィザードは、EJB 1.x エンティティー Bean 用のセッション Bean ファサードの生成をサポートしません。
  • CMP 属性を定義する際には、DataObject インターフェース内の EMF SDO で使用される名前は使用しないでください。例えば、属性に「type」、「int」、または「date」という名前は付けないでください。これは、生成される SDO クラスは DataObject インターフェースを基にしており、このインターフェースには既に getType、getInt、および getDate メソッドが含まれているためです。

このタスクについて

ワークベンチのセッション Bean ファサードと SDO の実装については、 『セッション Bean ファサードと SDO』を参照してください。

「セッション Bean ファサードの作成」ウィザードを使用してファサードを生成すると、以下のコードが生成されます。
  • セッション Bean
  • ファサードに役立つ 1 次 CMP エンティティー Bean のルート SDO
  • ファサードに組み込まれているそれぞれの CMP エンティティー Bean ごとの SDO
  • 選択されたそれぞれのコンテナー管理関係 (CMR) エンティティーごとの SDO
  • 各ルート SDO の新規インスタンス作成のためのメソッド付きクライアント・ファクトリー

このウィザードは、Bean と SDO 実装の定義に注釈を 用いる Java™ コード を生成します。 この注釈は、EJB ツールが、必要な Bean クラスの生成に使用します。注釈を変更することで、セッション Bean ファサードと SDO を変更できます。

@ws.sdo および @ws.sbf タグ・セットの参照情報については、 『セッション・ファサードと SDO のための注釈』を参照してください。

注釈に関連した作業に関する一般情報については、 『Annotation-based programming overview』を参照してください。

手順

  1. Java EE パースペクティブの「エンタープライズ・エクスプローラー」ビューで、EJB 2.x CMP エンティティー Bean を右クリックして、ポップアップ・メニューから「セッション Bean ファサードの作成」を選択します。 「セッション Bean ファサードの作成」ウィザードが開きます。
  2. 「名前」フィールドに、作成するセッション Bean ファサードの名前を入力します。
    注: プロジェクト内に既にセッション Bean ファサードがある場合は、既存のファサードを選択することもできます。 ウィザードで、複数の CMP エンティティー Bean の SDO を同じセッション Bean ファサードに追加することが可能です。
  3. 「使用可能な CMP Bean」フィールドで、セッション Bean ファサードに組み込むエンティティー Bean を選択し、「次へ」をクリックします。
  4. ウィザードの「SDO の作成」ページで、テーブル内のそれぞれの CMP エンティティー Bean ごとに作成する SDO の名前を入力します。
  5. オプション: 1 次 CMP エンティティー Bean のセッション・ファサードに create、update、および delete メソッドを組み込まない場合は、「読み取り専用」を選択します。 構成されたルート SDO には、含まれない SDO 用の create メソッドは含まれません。
  6. 「拡張を表示」ボタンをクリックして、それぞれの SDO ごとに組み込む CMP 属性とコンテナー管理関係 (CMR) エンティティーを指定します。
    「拡張」セクションには、選択された CMP エンティティー Bean で使用可能な次の 2 つの CMR エンティティー・ビューが含まれています。
    • それぞれの関係がリストされたテーブル
    • すべての属性と関係が示されているナビゲーション・ツリー
  7. ナビゲーション・ツリーを使用して、ファサード用に組み込む CMP 属性と関係を選択します。
    ヒント: SDO が読み取り専用でない場合、必須の属性と関係を組み込む必要があり、デフォルトで選択されます。 例えば、SDO が読み取り専用でないときには、エンティティー Bean の主キーと外部キーが必要です。
  8. CMR エンティティーのテーブル・ビューを使用して、以下のステップを実行します。
    1. オプション: ファサードに組み込まれた関係のために作成する SDO ごとに新しい名前を入力します。
    2. オプション: 関係を含めるかどうかを指定します。 関係を含めるかどうかの指定は、ウィザードが SDO を生成するかどうかに影響します。 生成されたルート SDO には、含まれない関係用の create メソッドが組み込まれています。
  9. オプション: 「次へ」をクリックして、クラス・ダイアグラムにセッション Bean ファサードを組み込むかどうかを指定します。
  10. 「終了」をクリックします。

次のタスク

ウィザードは注釈を生成し、ワークベンチはセッション Bean ファサードと SDO のクラスを生成します。

フィードバック