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 "Texo/ORM JPA Annotations Details"
(→Maintaining ORM model annotations) |
|||
| Line 7: | Line 7: | ||
== Maintaining ORM model annotations == | == Maintaining ORM model annotations == | ||
| − | ORM | + | The initial ORM annotations model can be created in the same way as described for code generation, see [[Texo/Code_Generation_Details#How_to_create_an_Annotations_Model|here]]. You start with an empty annotation model and create the nodes in the annotations model to add ORM annotations. |
| − | |||
| + | [[Image:org.eclipse.emf.texo.orm.annotations.model.png|center|700px]] | ||
| + | |||
| + | |||
| + | You can add ORM Annotations at each level of your model: EPackage, EClass, EAttribute, EReference and EDataType. By right clicking on an ORM Annotation node you can see which ORM specific annotations can be added: | ||
| + | |||
| + | |||
| + | [[Image:org.eclipse.emf.texo.adding.orm.annotation.png|center]] | ||
| + | |||
| + | |||
| + | Or: | ||
| + | |||
| + | |||
| + | [[Image:org.eclipse.emf.texo.adding.orm.annotation2.png|center]] | ||
| + | |||
| + | |||
| + | '''Note:''' it is possible to specify ORM annotations on an EDataType, these annotations are copied to each EAttribute using that EDataType. | ||
== Texo Mapping Decisions == | == Texo Mapping Decisions == | ||
Revision as of 17:19, 17 May 2010
Contents
Introduction
The Texo ORM generation can be controlled completely through an annotations model. The ORM/JPA model annotations make it possible to override/set all orm 2.0 annotations at model level. You only need to annotate the parts of the model which need extra attention. Texo will automatically add any missing annotations to get to a fully annotated model (while maintaining the manual settings).
Maintaining ORM model annotations
The initial ORM annotations model can be created in the same way as described for code generation, see here. You start with an empty annotation model and create the nodes in the annotations model to add ORM annotations.
You can add ORM Annotations at each level of your model: EPackage, EClass, EAttribute, EReference and EDataType. By right clicking on an ORM Annotation node you can see which ORM specific annotations can be added:
Or:
Note: it is possible to specify ORM annotations on an EDataType, these annotations are copied to each EAttribute using that EDataType.
Texo Mapping Decisions
Texo makes the following mapping decisions when generating an orm.xml:
- as a default all access is set at FIELD (this in contrast to the JPA default which is PROPERTY), only interfaces will use the PROPERTY access type.
- join tables are named as: entityname_efeaturename. This in contrast to the JPA default which specifies that a join table should be the concatenation of the names of the 2 tables which are joined. Texo uses a different approach as it provides a more robust naming without collisions.
- Texo will automatically manage which side is the owner in a bi-directional association.
- Texo chooses the entity name (is the same as the EClass name).
Future extensions
- Support the Map type
- Generate more database schema constructs in the orm.xml (column names for example).
- Make the database artifact/entity naming logic configurable