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 "STEM Model Generator/EAnnotations"
(→EPackage EAnnotations) |
(→EPackage EAnnotations) |
||
| Line 27: | Line 27: | ||
{| width="500" cellspacing="0" cellpadding="2" border="1" | {| width="500" cellspacing="0" cellpadding="2" border="1" | ||
|- | |- | ||
| − | | Description | + | | '''Description''' |
| colspan="2" | Generator Marker Annotation | | colspan="2" | Generator Marker Annotation | ||
|- | |- | ||
| − | | Required? | + | | '''Required?''' |
| colspan="2" | Yes | | colspan="2" | Yes | ||
|- | |- | ||
| − | | Source | + | | '''Source''' |
| colspan="2" | http:///org/eclipse/stem/modelgen/generated | | colspan="2" | http:///org/eclipse/stem/modelgen/generated | ||
|- | |- | ||
| − | | Details | + | | '''Details''' |
| Key | | Key | ||
| Value | | Value | ||
Revision as of 18:57, 5 September 2012
STEM Model Generator EAnnotation info coming soon.
Contents
Ecore EAnnotations
To generate code complying with the STEM API, additional information must be passed to the code generator that is out-of-scope to EMF's Ecore and GenModel schemas. To get around this, Ecore EAnnotations are used to pass information to the code generator. In order to use an Ecore/GenModel that wasn't generated automatically, you need to add these EAnnotations by hand.
Adding an EAnnotation to an EPackage/EClass/EAttribute
It's easy to add an EAnnotation to an existing Ecore model instance using the Ecore Editor.
- Open your project's .ecore file in the EMF Ecore Editor
- Right click on the object you wish to EAnnotate. Select New Child, EAnnotation.
- Right click on the new EAnnotation and select Show Properties View
- In the Properties view, enter a value for the Source
- Note: This is generally a URI. See below for appropriate EAnnotation Source values for use with STEM's Model Generator
- Right click on the new EAnnotation. Select New Child, Details Entry.
- Select the new EAnnotation Detail Entry
- In the Properties view, enter values for Key and Value
- Note: See below for values to use with STEM's Model Generator
- Repeat this step for additional Detail Entries
- Save the Ecore file
EAnnotations used in STEM's Model Generator
EPackage EAnnotations
These are EAnnotations that should be applied to the parent EPackage of your STEM Disease/Population model.
| Description | Generator Marker Annotation | |
| Required? | Yes | |
| Source | http:///org/eclipse/stem/modelgen/generated | |
| Details | Key | Value |
| version | 1.0 | |
Integration Decorator EAnnotations
EClass
EAttribute
Integration Label EAnnotations
EClass
Integration Label Value EAnnotations
EAttribute
GenModel Settings
To take advantage of the STEM Model Generator's custom templates, you must enable Dynamic Templates in your project's GenModel.
- Open your project's .genmodel in the EMF Generator editor
- Select the top level item (the GenModel)
- Right click and select Show Properties View
- Apply the following settings exactly as specified. When finished, Save the GenModel.
Property Value Compliance Level 6.0 Runtime Version 2.7 Suppress Notification true Public Constructors true Dynamic Templates true Force Overwrite true Templates Directory platform:/plugin/org.eclipse.stem.model.codegen/templates Template Plug-in Variables STEM_CODEGEN=org.eclipse.stem.model.codegen Update Classpath true
Running the Code Generator
After you finish editing the Ecore and GenModel, you can now run the STEM Model Generator directly. The STEM Model Generator acts as an EMF Generator Adapter, therefore it runs automatically when you execute the EMF Code Generator.
- Open your project's .genmodel in the EMF Generator editor
- Select the top-level item (the GenModel)
- Right click and select a Generate option (Generate All, for example)
- Wait while the EMF Code Generator + STEM Model Generator run