EJB JAR ファイル -> 「関係」タブ付きパネル -> 「Sun 固有の設定」ボタン
または
EJB JAR ファイル -> 「一般」タブ付きパネル -> 「Sun 固有の設定」ボタン
または
エンタープライズ Bean -> 「一般」タブ付きパネル -> 「Sun 固有の設定」ボタン
または
エンタープライズ Bean -> 「エンティティ」タブ付きパネル -> 「Sun 固有の設定」ボタン
「CMP データベース」ダイアログボックスでは、Sun Java System Application Server に固有の EJB JAR ファイルの実行時のコンテナ管理による持続性プロパティを編集できます。
この EJB JAR を配備中のサーバーインスタンスで使用可能な JNDI 名を指定します。たとえば、CMP Roster サンプルアプリケーションの場合、JNDI 名は jdo/cmp-roster です。
この名前は持続リソースを管理するために、実行時に使用されます。
「データベースマッピングを作成」ボタンをクリックすると、この EJB JAR ファイル用の「データベースマッピングを作成」ダイアログボックスが開きます。 この EJB JAR 内のエンタープライズ Bean をデータベースにマッピングする方法を指定できます。次のオプションがあります。
必要な表を自動的に生成 - デフォルトでは、このオプションが選択されています。
データベーススキーマファイル内の表へのマップ
「表生成の設定」ボタンをクリックすると、この EJB JAR ファイル用の「表生成の設定」ダイアログボックスが開きます。「表生成の設定」ダイアログボックスでは、モジュールの配備中に CMP テーブルを作成するかどうか、およびモジュールが配備解除されたときに削除するかどうかを指定できます。ボタンは、自動表生成モードの場合にのみ使用できます。
「エンタープライズ Bean」ドロップダウンリストから、CMP 設定を定義するエンタープライズ Bean を選択します。
自動表生成モードでは、主表は定義済みで、「主表」ドロップダウンリストは無効になっています。
「詳細設定」ボタンをクリックし、「詳細設定 (表生成モード)」ダイアログボックスで整合性レベルを定義します。
「フィールドマッピング」セクションには、持続フィールドのマッピングが表示されます。
フィールド - この列には、持続されるフィールドが一覧表示されます。これらのフィールドは、エンタープライズ Bean の「エンティティ」タブ付きパネルで選択します。この列は常に無効です。持続フィールドになるようにフィールドを追加または削除するには、「エンティティ」タブを使用します。
マッピングされた列 - この列には、データベース内の持続フィールドにマッピングされた列が表示されます。このマッピングは変更できません。
タイプ - 「列のタイプを編集」ダイアログボックスでこの列をクリックしてタイプを変更します。
フェッチ - この列では、フィールドおよびマッピングのフェッチグループ設定を指定します。フィールドは階層または独立したフェッチグループに加わることができます。
「エンタープライズ Bean」ドロップダウンリストから、CMP 設定を定義するエンタープライズ Bean を選択します。
利用可能な主表のリストから主表を選択します。
「詳細設定」ボタンをクリックし、「詳細設定 (マッピングモード)」ダイアログボックスでスキーマファイルの選択、整合性レベルの定義、1 つ以上の二次表の選択を行います。
「フィールドマッピング」セクションでは、フィールドのドロップダウンリストから列を選択することで、そのフィールドを列にマッピングできます。
フィールド - この列には、持続されるフィールドが一覧表示されます。これらのフィールドは、エンタープライズ Bean の「エンティティ」タブ付きパネルで選択します。この列は常に無効です。持続フィールドになるようにフィールドを追加または削除するには、「エンティティ」タブを使用します。
マッピングされた列 - 「マッピングされた列」では、持続フィールドのマッピングを変更できます。ドロップダウンリストからマッピングを選択します。リストから「複数列をマップ」オプションを選択すると、「フィールドを複数の列にマッピング」ダイアログボックスが表示されます。
タイプ - 「タイプ」列には、選択された「マッピングされた列」のデータタイプが表示されます。この列は、マッピングモードでは無効になります。
フェッチ - この列では、フィールドおよびマッピングのフェッチグループ設定を指定します。フィールドは階層または独立したフェッチグループに加わることができます。
「すべてを自動マップ」を選択すると、現在選択されているエンタープライズ Bean のフィールドをマッピングできます。「すべてを自動マップ」を実行すると、最も論理的な選択が行われ、関係フィールドを含むすべてのマッピングが更新されます。ただし、「すべてを自動マップ」をクリックすると、現在のマッピングはすべて無効になります。
「すべてをマップ解除」ボタンでは、現在選択されているエンタープライズ Bean のすべてのマッピングが削除されます。
注: データベースのメータデータ (スキーマファイル) を取り込まないでマッピングファイル (sun-cmp-mappings.xml) を使用する場合、配備ツールは「フィールドマッピング」表にこのマッピングを表示できません。しかし、このマッピングファイルは依然有効であり配備可能です。このマッピングファイルを使用し続けるか、または「データベースマッピングを作成」ボタンをクリックして新しいマッピングを作成できます。