Hitachi

Cosminexus V11 アプリケーションサーバ 機能解説 互換編


8.22.36 @OneToMany

〈この項の構成〉

(1) 説明

OneToManyリレーションシップの関係を持つ所有者側のエンティティクラスから被所有者側のエンティティクラスへの複数の関連を指定するアノテーションです。

@OneToManyのための同じアノテーションの属性は,@ManyToManyと同じ属性を持ちます。

なお,Genericsを使用してCollection要素型が指定されている場合,被所有者側のエンティティクラスを指定する必要はありません。そのほかの場合は,必ず指定してください。

また,双方向の関係にする場合は,非所有者側に必ずmappedBy属性を指定してください。

適用可能要素は,メソッドとフィールドです。

(2) 属性

@OneToManyの属性の一覧を次の表に示します。

属性名

任意/必須

属性の説明

targetEntity

任意

被所有者側のエンティティクラスを指定する属性です。

cascade

任意

カスケード対象となるオペレーションを指定する属性です。

fetch

任意

フェッチ戦略の指定値を指定する属性です。

mappedBy

任意

被所有者側のエンティティクラスの要素に付与し,所有者側のエンティティクラスで関係を保持しているフィールドまたはプロパティの名前を指定する属性です。

CJPAプロバイダで対応する属性の詳細を次に示します。

(a) targetEntity属性

Class

説明

被所有者側のエンティティクラスを指定する属性です。

Genericsを使って定義されているコレクションプロパティの場合は,任意で指定します。それ以外の場合は必ず指定してください。

デフォルト値

コレクションのパラメタ化された型

注 Genericsを使って定義されているときにだけ設定されます。

(b) cascade属性

CascadeType[]

説明

カスケード対象となるオペレーションを指定する属性です。

指定できる値を次に示します。

  • CascadeType.ALL:所有者側のエンティティクラスのpersist,remove,merge,およびrefreshの操作が関連先にカスケードされます。

  • CascadeType.MERGE:所有者側のエンティティクラスのmerge操作が関連先にカスケードされます。

  • CascadeType.PERSIST:所有者側のエンティティクラスのpersist操作が関連先にカスケードされます。

  • CascadeType.REFRESH:所有者側のエンティティクラスのrefresh操作が関連先にカスケードされます。

  • CascadeType.REMOVE:所有者側のエンティティクラスのremove操作が関連先にカスケードされます。

デフォルト値

カスケード対象なし

(c) fetch属性

FetchType

説明

データベースからのデータのフェッチ戦略を定義する属性です。フェッチ戦略については,「8.4.5 データベースとの同期」を参照してください。

指定できる値は,次の2種類です。

  • EAGER戦略:データがEAGERにフェッチされなければならない要求

  • LAZY戦略:データが最初にアクセスされるときに,LAZYにフェッチされる要求

デフォルト値

FetchType.LAZY

(d) mappedBy属性

String

説明

被所有者側のエンティティクラスの要素に付与し,所有者側のエンティティクラスで関係を保持しているフィールドまたはプロパティの名前を指定する属性です。

この属性を指定した場合,関係は双方向になります。

デフォルト値

なし