@TypeConverter

@TypeConverterを使用して、マップ済属性の読取りおよび書込み中にデータ値を変更します。

注釈要素

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

表2-72 @TypeConverterの注釈要素

注釈要素	説明	デフォルト
`name`	(必須)コンバータの`String`の名前。この名前は、永続性ユニット間で一意である必要があります。	なし
`dataType`	(オプション)データベースに格納される`type`。	`void.class`^脚注 1
`objectType`	(オプション)エンティティに格納される`type`。	`void.class`^脚注 1

^脚注 1デフォルトは、永続性フィールドまたはプロパティのタイプから推測されます。

使用方法

各TypeConverterは、一意の名前を付ける必要があり、クラス、フィールドおよびプロパティ・レベルで定義でき、エンティティ、MappedSuperclassおよび埋込み可能クラス内で指定できます。TypeConverterは、常に@Convert注釈を使用して指定されます。

@TypeConverterをBasic、BasicMapまたはBasicCollectionマッピングに配置できます。

Oracle TopLinkには、@ObjectTypeConverterおよび@StructConverterコンバータも含まれます。

例

例2-116に、@TypeConverter注釈を使用して、データベースに格納されたDouble値をエンティティに格納されたFloat値に変換する方法を示します。

例2-116 @TypeConverter注釈の使用

@Entity
public class Employee implements Serializable{

...

  @TypeConverter (
    name="doubleToFloat",
    dataType=Double.class,
    objectType=Float.class,
  )
  @Convert("doubleToFloat")
  public Number getGradePointAverage() {
    return gradePointAverage;
  }

...
}