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/Configuration/JPA/eclipselink-orm.xml"
m (→eclipselink-orm.xml) |
m (→eclipselink-orm.xml) |
||
| Line 5: | Line 5: | ||
=eclipselink-orm.xml= | =eclipselink-orm.xml= | ||
| − | You can use EclipseLink’s native metadata xml file, '''EclipseLink-ORM.XML''', to override mappings defined in JPA’s configuration file orm.xml and provide EclipseLink with extended ORM features. | + | You can use EclipseLink’s native metadata xml file, '''EclipseLink-ORM.XML''', to override mappings defined in JPA’s configuration file orm.xml and provide EclipseLink with extended ORM features. |
| + | {{EclispeLink_Note | ||
| + | |note=Using the '''eclipselink-orm.xml''' mapping file will enable many EclipseLink advanced features, but may prevent the persistence unit from being portable to other JPA implementations.}} | ||
The '''EclipseLink-ORM.XML''' file defines the object-relational mapping metadata for EclipseLink. It is built from the existing [[EclipseLink/UserGuide/JPA/Basic JPA Development/Configuration/JPA/orm.xml|orm.xml file]] which makes it more intuitive, requires minimum configuration, and easy to override. | The '''EclipseLink-ORM.XML''' file defines the object-relational mapping metadata for EclipseLink. It is built from the existing [[EclipseLink/UserGuide/JPA/Basic JPA Development/Configuration/JPA/orm.xml|orm.xml file]] which makes it more intuitive, requires minimum configuration, and easy to override. | ||
Revision as of 14:24, 17 June 2010
Examples
eclipselink-orm.xml
You can use EclipseLink’s native metadata xml file, EclipseLink-ORM.XML, to override mappings defined in JPA’s configuration file orm.xml and provide EclipseLink with extended ORM features. Template:EclispeLink Note
The EclipseLink-ORM.XML file defines the object-relational mapping metadata for EclipseLink. It is built from the existing orm.xml file which makes it more intuitive, requires minimum configuration, and easy to override.
For more information, see Section 10.1 "XML Overriding Rules" in the JPA Specification.
Overriding and Merging
To override orm.xml file's mapping, you must define the META-INF/eclipselink-orm.xml file in the project. When both orm.xml and eclipselink-orm.xml are specified, the contents of eclipselink-orm.xml override orm.xml and any other JPA mapping file specified in the persistence unit. If there are overlapping specifications in multiple ORM files, the files are merged if they are no conflicting entities.
See Overriding and Merging for more information
