@Property

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

注釈要素

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

表2-55 @Propertyの注釈要素

注釈要素	説明	デフォルト
`name`	(必須)プロパティの名前。
`value`	(必須)プロパティの`value`の文字列表現。`valueType`のインスタンスに変換されます。
`valueType`	(オプション)プロパティの値タイプ。`ConversionManager`によってvalueTypeに変換されます。`ConversionManager`で処理できる単純なタイプである必要があります。	`String`

使用方法

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

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

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

例

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