Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "EclipseLink/UserGuide/JPA/Basic JPA Development/Mapping/Basic Mappings/Default Conversions and Converters"
< EclipseLink | UserGuide | JPA | Basic JPA Development | Mapping | Basic Mappings
m |
m |
||
(9 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
− | {{EclipseLink_UserGuide}} | + | {{EclipseLink_UserGuide|info=y |
+ | |api=y | ||
+ | |apis= | ||
+ | * [http://www.eclipse.org/eclipselink/api/latest/org/eclipse/persistence/annotations/Converter.html @Converter] | ||
+ | * [http://www.eclipse.org/eclipselink/api/latest/org/eclipse/persistence/annotations/TypeConverter.html @TypeConverter] | ||
+ | * [http://www.eclipse.org/eclipselink/api/latest/org/eclipse/persistence/annotations/ObjectTypeConverter.html @ObjectTypeConverter] | ||
+ | * [http://www.eclipse.org/eclipselink/api/latest/org/eclipse/persistence/annotations/StructConverter.html @StructConverter] | ||
+ | * [http://www.eclipse.org/eclipselink/api/latest/org/eclipse/persistence/annotations/Convert.html @Convert] | ||
+ | }} | ||
+ | |||
=Default Conversions and Converters= | =Default Conversions and Converters= | ||
EclipseLink defines the following converter annotations and XML attributes (in addition to JPA-defined ones): | EclipseLink defines the following converter annotations and XML attributes (in addition to JPA-defined ones): | ||
− | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Converter|@Converter | + | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Converter|@Converter]]</tt> |
− | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/TypeConverter|@TypeConverter | + | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/TypeConverter|@TypeConverter]]</tt> |
− | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/ObjectTypeConverter|@ObjectTypeConverter | + | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/ObjectTypeConverter|@ObjectTypeConverter]]</tt> |
− | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/StructConverter|@StructConverter | + | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/StructConverter|@StructConverter]]</tt> |
− | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Convert|@Convert | + | * <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Convert|@Convert]]</tt> |
EclipseLink persistence provider searches the converter annotations in the following order: | EclipseLink persistence provider searches the converter annotations in the following order: | ||
− | + | # <tt>[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Convert|@Convert]]</tt> | |
− | + | # <tt>@Enumerated|@Enumerated</tt> | |
− | + | # <tt>@Lob</tt> | |
− | + | # <tt>@Temporal</tt> | |
− | + | # Serialized (automatic) | |
You can define converters at the class, field and property level. You can specify EclipseLink converters on the following classes: | You can define converters at the class, field and property level. You can specify EclipseLink converters on the following classes: | ||
− | * <tt>@Entity</tt> | + | * <tt>@Entity</tt> |
− | * <tt> | + | * <tt>@MappedSuperclass</tt> |
− | * <tt> | + | * <tt>@Embeddable</tt> |
You can use EclipseLink converters with the following mappings: | You can use EclipseLink converters with the following mappings: | ||
− | * <tt> | + | * <tt>@Basic</tt> |
− | * <tt> | + | * <tt>@Id</tt> |
− | * <tt> | + | * <tt>@Version</tt> |
− | * <tt> | + | * <tt>@BasicMap</tt> |
− | * <tt> | + | * <tt>@BasicCollection</tt> |
If you specify a converter with any other type of mapping annotation, EclipseLink will throw an exception. | If you specify a converter with any other type of mapping annotation, EclipseLink will throw an exception. | ||
Line 35: | Line 44: | ||
{{EclipseLink_JPA | {{EclipseLink_JPA | ||
− | |previous=[[EclipseLink/UserGuide/JPA/Basic JPA Development/Mapping/Basic Mappings/Column|Column]] | + | |previous=[[EclipseLink/UserGuide/JPA/Basic JPA Development/Mapping/Basic Mappings/Column|@Column]] |
|next=[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Converter|@Converter]] | |next=[[EclipseLink/UserGuide/JPA/Basic_JPA_Development/Mapping/Basic_Mappings/Default_Conversions_and_Converters/Converter|@Converter]] | ||
|up=[[EclipseLink/UserGuide/JPA/Basic JPA Development/Mapping/Basic Mappings|Basic Mappings]] | |up=[[EclipseLink/UserGuide/JPA/Basic JPA Development/Mapping/Basic Mappings|Basic Mappings]] | ||
− | |version=2. | + | |version=2.2.0 DRAFT |
}} | }} |
Latest revision as of 10:02, 5 May 2011
EclipseLink | |
Website | |
Download | |
Community | |
Mailing List • Forums • IRC • mattermost | |
Issues | |
Open • Help Wanted • Bug Day | |
Contribute | |
Browse Source |
Default Conversions and Converters
EclipseLink defines the following converter annotations and XML attributes (in addition to JPA-defined ones):
EclipseLink persistence provider searches the converter annotations in the following order:
- @Convert
- @Enumerated|@Enumerated
- @Lob
- @Temporal
- Serialized (automatic)
You can define converters at the class, field and property level. You can specify EclipseLink converters on the following classes:
- @Entity
- @MappedSuperclass
- @Embeddable
You can use EclipseLink converters with the following mappings:
- @Basic
- @Id
- @Version
- @BasicMap
- @BasicCollection
If you specify a converter with any other type of mapping annotation, EclipseLink will throw an exception.