手順 6. O/R マッピングを生成する

Workshop は、Hibernate のような一般的な永続性サービスを利用するための、多彩で柔軟性のあるオブジェクトリレーショナルマッピングインタフェースを備えています。O/R マッピングは、開発手法に応じて以下の異なるメカニズムで生成できます。

スキーマをリバースエンジニアリングしてオブジェクトリレーショナルマッピングを作成する
オブジェクトモデルからマッピングを生成する

この手順では、両方のシナリオに従って O/R マッピングを生成します。この手順のタスクは以下のとおりです。

データベーススキーマからオブジェクトモデルとマッピングファイルを作成する
CUSTOMER と CUSTOMERID の間に 1 対 1 の関連付けを新しく作成する
Spring Bean を生成する

データベーススキーマからオブジェクトモデルとマッピングファイルを作成する

この手順では、データベーススキーマをリバースエンジニアリングする方法によって、関連するオブジェクトモデルとマッピングを Workshop で自動生成します。

[DbXplorer] ビュー内の空白部分で右クリックし、[Hibernate マッピングの生成...] を選択します。
[Web アプリケーション] ダイアログで workshop-hibernate-tutorial を選択し、[OK] をクリックします。
以下に示す [Hibernate ORM の生成] ダイアログで、データベーステーブルを選択して、[次へ] をクリックします。

CONTACT データベーステーブルは選択しないでください。トップダウンの開発手法を理解できるように、このチュートリアルの後半で、CONTACT データベースを使用して Contact オブジェクトモデルから Hibernate マッピングファイルを生成します。
[テーブルの関連付け] ダイアログに、外部キー定義に基づいてデータベーススキーマから抽出されたエンティティ関係が表示されます。このダイアログでは、各テーブルの関連を選択し、編集パネルでオプションを変更することでそれらを編集できます。

LINEITEM と ORDER_DATA の間の関連を選択します。
1 番目の [プロパティ] フィールドの値を、「orderData」から「order」に変更します。
LINEITEM と PRODUCT の間の関連を選択します。
[Generate a reference to a collection of Lineitem in Product] チェックボックスの選択を解除します。(LINEITEM と PRODUCT の間に、多対 1 の一方向の関係を定義する必要があるためです。)
ORDER_DATA と CUSTOMER の間の関連付けを選択します。
2 番目の [プロパティ] フィールドの値を orderData から orders に変更します。
[次へ] はクリックしないでください。

CUSTOMER と CUSTOMERID の間に 1 対 1 の関連付けを新しく作成する

Workshop では、新しい関連付けを作成することもできます。2 つのテーブル間の単純な関連付け (1 対 1、1 対多、多対 1) と、中間テーブルを介した多対多の関連付けを作成できます。

[新しい関連付けの作成] オプションをクリックし、新しい関連付けのプロパティを指定します。
[新しい関連付けの作成] ダイアログで、[Table 1] ドロップダウンを使用して、[CUSTOMER] を選択します。
[Table 2] ドロップダウンを使用して、[CUSTOMERID] を選択します。
[次へ] をクリックします。
[結合カラム] ダイアログで、テーブル間の結合カラムを指定します。
[CUSTOMER] テーブルドロップダウンで、[CUSTOMERID] カラムを選択します。
[CUSTOMERID] テーブルドロップダウンで、[CUSTOMERID] カラムを選択します。
[次へ] をクリックします。
[1 対 1] を選択して、1 人の顧客と 1 つの顧客 ID が対応するようにします。
[完了] をクリックします。
新しい関連付け (茶色のボックス) はデータベーススキーマから抽出されたものではないため、Hibernate マッピングファイルおよびオブジェクトモデル内にプログラムによって作成されます。

[Hibernate ORM の生成] ダイアログで [次へ] をクリックします。
[デフォルトテーブルの生成] ダイアログの [キージェネレータ] ドロップダウンで、[increment] を選択します。
[Java パッケージ] フィールドの横にある [参照] をクリックします。
[Java パッケージの選択] ダイアログで、[新しい Java パッケージ] をクリックします。
[新しい Java パッケージ] ダイアログの [名前] フィールドに com.bea.beans と入力して [終了] をクリックします。
[Java パッケージの選択] ダイアログで、[OK] をクリックします。
[Hibernate ORM の生成] ダイアログで、[次へ] をクリックします。
[テーブルとカラム] ダイアログで、生成されるマッピングファイルと Bean クラスのテーブルマッピング名およびカラムマッピング名を定義します。デフォルトでは、Hibernate マッピングファイルと JavaBean に、スキーマのテーブル名およびカラム名が使用されます。テーブルまたはカラムをポイントすると、データベーススキーマに定義されているテーブルおよびカラムのプロパティがツールチップに表示されます。

[次へ] をクリックします。
[マッピングの生成] ダイアログでは、マッピングファイルの拡張子を選択できます。ドメイン Java クラスを生成するかどうかや、Hibernate コンフィグレーションファイル hibernate.cfg.xml を更新するかどうかも指定できます。

デフォルトを受け入れて [完了] をクリックします。

AppXplorer

Hibernate コンフィグレーション

Hibernate ORM の生成

Spring Bean を生成する

この時点で、必要に応じて Spring Bean と Spring コンフィグレーションを生成することができます。

このタスクには以下の作業があります。

生成したマッピングとクラスを確認する
永続性クラスから Hibernate マッピングファイルを作成する

生成したマッピングとクラスを確認する

[AppXplorer] ビューで、[workshop-hibernate-tutorial｜web｜Hibernate コンフィグレーション｜エンティティ] ノードを開きます。
Workshop によって生成された一連の永続性エンティティを確認します。永続性エンティティは、hibernate.cfg.xml ファイルで指定された、拡張子 .hbm.xml を持つマッピングリソースに基づいて識別されます。
オブジェクトモデルは、パッケージの [web/WEB-INF/src/java] ブランチに表示されます。

永続性クラスから Hibernate マッピングファイルを作成する

この手順では、永続性 Java クラス Contact を作成し、Workshop を使用して、Contact オブジェクトの Hibernate マッピングを生成します。これにより、トップダウンの開発手法に従って作業を進めます。

[AppXplorer] ビューで [workshop-hibernate-tutorial｜web/WEB-INF/src/java｜com.bea.beans] ノードを開きます。
[com.bea.beans] を右クリックして [新規｜クラス] を選択します。
[新規 Java クラス] ダイアログで、java.io.Serializable インタフェースを実装する Java クラス Contact を作成します。([追加] をクリックして、java.io.Serializable インタフェースを追加します)。
Contact クラスに以下のプライベート変数 (String 型) を追加します。注意 : ここでは、CONTACT データベーステーブル内のカラムにマップするプロパティを定義しています。

private String contactId;
private String address;
private String city;
private String phone;
引数なしのコンストラクタを追加します。

public Contact( ) {
super( );
}
ソースペイン内で右クリックし、[ソース｜Getter および Setter の生成] を選択して、各プロパティのゲッターメソッドとセッターメソッドを追加します。[Getter および Setter の生成] ダイアログで、[すべて選択] をクリックして [OK] をクリックします。
以下のプロパティを追加します。

private static final long serialVersionUID = 1L;

Set 内の Contact インスタンスを使用するために、equals( ) メソッドと hashCode( ) メソッドを追加します。

public boolean equals(Object other) {
  if ( (this == other ) ) return true;
  if ( !(other instanceof Contact) ) return false;
  Contact castOther = (Contact) other;
  if( this.getContactId( ).equals(castOther.getContactId( )) ) {
    return true;
  } else {
    return false;
  }
}

public int hashCode() {
   return this.getContactId( ).hashCode( );
}

Contact クラスを保存します。これで、CONTACT 永続性データのオブジェクト表現が作成できました。次に、Contact オブジェクトから Hibernate O/R マッピングファイルを作成します。
[AppXplorer] ビューで、workshop-hibernate-tutorial プロジェクトを右クリックして、[新規｜その他] を選択します。[Hibernate] を展開し、[Java クラスからの Hibernate マッピング] を選択して [次へ] をクリックします。
Java クラスの [参照] ボタンをクリックします。
[Choose Type] ダイアログで、Contact と入力し、com.bea.beans.Contact オブジェクトを選択して、[OK] をクリックします。
[Hibernate マッピングの生成.] ダイアログで、[次へ] をクリックします。
[クラスマッピングのプロパティ] ダイアログで、[次へ] をクリックします。