@Properties

@Propertyを使用して、マップ済属性またはget/setメソッドに単一のユーザー定義済プロパティを指定します。@Properties注釈を使用して、複数のプロパティをラップします。

TopLinkでは使用されませんが、アプリケーションまたは拡張機能でTopLinkメタデータを拡張する必要がある場合は、マッピング・プロパティを指定できます。

注釈要素

表2-54は、この注釈の要素を示しています。

表2-54 @Propertiesの注釈要素

注釈要素	説明	デフォルト
Property	`Property`要素の配列

使用方法

エンティティ、MappedSuperclassまたは埋込みクラス内のマップ済属性(またはget/setメソッド)に@Propertyを指定できます。エンティティ、MappedSuperclassまたは埋込み可能クラスにもこの注釈を指定できます。

MappedSuperclassに定義されたプロパティは、すべての継承エンティティおよびMappedSuperclassに渡されます。競合する場合は、クラスに直接定義されたプロパティがクラスの親から継承された値よりも常に優先されます。

orm.xmlマッピング・ファイルを使用すると、TopLinkは、マップ済属性の注釈で指定された@Propertyおよび@Propertiesを無視します。クラスの注釈は、orm.xmlファイルに指定された注釈にマージされ、競合している場合はファイルに指定された注釈が優先されます。

例

例2-114に、@Transformationマッピング内で@Properties注釈を使用する方法を示します。例2-115に、orm.xmlファイル内の<properties> XML要素を使用する方法を示します。