6.2. コレクションのマッピング
注記
多くの一般的なリレーショナルモデルに対応するコレクション向けに生成可能な マッピングにはかなりの幅があります。様々なマッピング宣言がどのようにデータベーステーブルに変換されるかを知るために、スキーマ生成ツールを使ってみると良いでしょう。
コレクションをマッピングする際に利用するHibernateマッピング要素は、インターフェースの型に依存します。例えば、
<set> 要素は Set 型のプロパティをマッピングするために使います。
<class name="Product">
<id name="serialNumber" column="productSerialNumber"/>
<set name="parts">
<key column="productSerialNumber" not-null="true"/>
<one-to-many class="Part"/>
</set>
</class>
マッピング要素には
<set> の他に <list>、 <map>、 <bag>、 <array>、 <primitive-array> があります。代表として、 <map> 要素を下記に示します。
<map
name="propertyName" 
table="table_name" 
schema="schema_name" 
lazy="true|extra|false" 
inverse="true|false" 
cascade="all|none|save-update|delete|all-delete-orphan|delete-orphan" 
sort="unsorted|natural|comparatorClass" 
order-by="column_name asc|desc" 
where="arbitrary sql where condition" 
fetch="join|select|subselect" 
batch-size="N" 
access="field|property|ClassName" 
optimistic-lock="true|false" 
mutable="true|false" 
node="element-name|."
embed-xml="true|false"
>
<key .... />
<map-key .... />
<element .... />
</map>
| name コレクションのプロパティ名
|
| table（オプション - デフォルトはプロパティ名）コレクションテーブルの名前。これは一対多関連では使用しません。
|
| schema （オプション）テーブルスキーマの名前。ルート要素で宣言されているスキーマより優先されます。
|
| lazy（オプション - デフォルトは true）遅延フェッチを無効にし、関連を常に即時にフェッチにするために使用します。または、コレクションを初期化しない多くの操作において、 「extra-lazy」フェッチを有効にするために使用します。これは大きなコレクションに適しています。
|
| inverse （オプション - デフォルトは false） このコレクションが双方向関連の「逆」側であるとマークします。
|
| cascade （オプション - デフォルトは none）：子エンティティへのカスケード操作を有効にします。
|
| sort（オプション）: naturalな順序でソートされた コレクションもしくは、ある Comparator クラスを指定します。
|
| order-by（オプション、 JDK1.4 のみ）Map、Set、bag のイテレーション順序を定義するテーブルカラムを指定すると共に、オプションとして asc、 desc を指定します。
|
| where （オプション）コレクションの検索や削除の際に使う任意の SQL のWHERE 条件を指定します。これは、利用可能なデータの一部分だけをコレクションが含むべきときにこれは有用です。
|
| fetch（オプション - デフォルトは select） 外部結合によるフェッチ、順次選択フェッチ （sequential select fetch） 、順次サブセレクトフェッチ （sequential subselect fetch） のいずれかを選択してください。
|
| batch-size（オプション - デフォルトは 1）このコレクションのインスタンスを遅延フェッチするために、「バッチサイズ」を指定します。
|
| access（オプション - デフォルトは property）Hibernate がコレクションプロパティの値にアクセスするために使用する戦略です。
|
| optimistic-lock （オプション - デフォルトは true） コレクションの状態を変えることによって、そのオーナーであるエンティティのバージョンがインクリメントされるかを指定します。一対多関連では無効に設定するのが妥当です。
|
| mutable（オプション - デフォルトは true）false 値は、コレクションの要素が決して変更されないことを表します。一部の場合で若干パフォーマンスを高めることができます。
|
6.2.1. コレクションの外部キー
コレクションのインスタンスは、データベース内では、そのコレクションを所有するエンティティの外部キーによって識別されます。この外部キーはコレクションテーブルの コレクションキーカラム またはカラムと呼ばれます。コレクションキーカラムは
<key> 要素によりマッピングします。
外部キーカラムには null 設定制約があるかもしれません。ほとんどのコレクションに当てはまるでしょう。単方向の一対多関連において、外部キーカラムはデフォルトで null を許容する設定になっています。よって、
not-null="true" を指定する必要があるかもしれません。
<key column="productSerialNumber" not-null="true"/>
外部キーの制約が
ON DELETE CASCADE を使う場合もあります。
<key column="productSerialNumber" on-delete="cascade"/>
<key> 要素のすべての定義については前の章を参照してください。
