Difference between revisions of "EMF/ExtendingCodeGeneration"

From Eclipsepedia

< EMF
Jump to: navigation, search
(Links)
 
(14 intermediate revisions by one user not shown)
Line 5: Line 5:
 
A sample implementation is the project org.eclipse.emf.examples.generator.validator
 
A sample implementation is the project org.eclipse.emf.examples.generator.validator
  
(see :pserver:anonymous@dev.eclipse.org:/cvsroot/modeling under org.eclipse.emf/org.eclipse.emf/examples)
+
(See git.eclipse.org/gitroot/emf under org.eclipse.emf/org.eclipse.emf/examples, or [https://git.eclipse.org/c/emf/org.eclipse.emf.git/tree/examples/org.eclipse.emf.examples.generator.validator on the web interface])
  
  
Line 30: Line 30:
 
In the method canGenerated you have to return true for your project types.
 
In the method canGenerated you have to return true for your project types.
  
The prefix "GenClass" says this adapter works with the GenClass class of the genmodel.
+
The prefix "GenClass" says this adapter works with the GenClass class of the genmodel, but this is just a naming convention .
  
 
In accordance to this you have to configure the extension point or you write a GeneratorAdapterFactory.  
 
In accordance to this you have to configure the extension point or you write a GeneratorAdapterFactory.  
Line 40: Line 40:
  
 
Take care not all combinations and of project type and adapter type produce output. (e.g. I had no luck in the combination GenClass and EDITOR project)
 
Take care not all combinations and of project type and adapter type produce output. (e.g. I had no luck in the combination GenClass and EDITOR project)
 +
 +
== Package Generator Adapter ==
 +
 +
If you write a GenPackage generator adapter you should verify in your generate method (in most cases) if it is required to generate an e.g. new class for it.
 +
The package in the model may on a higher level, but you get a call for all (selected) packages in the model.
 +
 +
<source lang="java">
 +
 +
if (genPackage.hasConcreteClasses()) {
 +
  message = "Generating class XYZ"; /
 +
  monitor.subTask(message);
 +
 +
  generateJava(....);
 +
} else {
 +
  monitor.worked(1);
 +
}
 +
</source>
 +
 +
A good example is the class GenPackageGeneratorAdapter of EMF itself, you can find it simply  by the "Open Type..." command.
 +
 +
=  Dynamic Templates & Generator Adapter =
 +
 +
To combine a Generator Adapter and a Dynamic Templates you can add the following URI in the GemModel "Template Directory" property
 +
* platform:/plugin/<plugin-id>/templates
 +
 +
If you have some problems during generation (e.g. it generate still the old version) it may help to remove the (hidden) project ".JETEmitter" from you testing workspace (if you just delete it don't forget to refresh the workspace)
  
 
=  JET Templates =
 
=  JET Templates =
Line 51: Line 77:
  
 
* http://www.eclipse.org/forums/index.php?t=msg&S=26948a7500a8f8b49cfde1a577ad810c&th=155261&goto=48916
 
* http://www.eclipse.org/forums/index.php?t=msg&S=26948a7500a8f8b49cfde1a577ad810c&th=155261&goto=48916
 +
 +
Forum entries related to how to combine a generator and dynamic templates
 +
 
* http://www.eclipse.org/forums/index.php?t=msg&goto=647243&S=26948a7500a8f8b49cfde1a577ad810c#msg_647243
 
* http://www.eclipse.org/forums/index.php?t=msg&goto=647243&S=26948a7500a8f8b49cfde1a577ad810c#msg_647243
 
* http://www.eclipse.org/forums/index.php?t=rview&goto=480066&th=152145
 
* http://www.eclipse.org/forums/index.php?t=rview&goto=480066&th=152145
 
+
* http://www.eclipse.org/forums/index.php?t=msg&goto=415810&S=6b757ff8567e4b1a93cbdc4439a9d208
  
 
Here another example:  
 
Here another example:  
 
http://code.google.com/a/eclipselabs.org/p/emf/source/browse/#hg%2Forg.eclipselabs.emf.codegen.addon
 
http://code.google.com/a/eclipselabs.org/p/emf/source/browse/#hg%2Forg.eclipselabs.emf.codegen.addon

Latest revision as of 05:41, 4 March 2013

Contents

[edit] Summary

The intension of this page to collect experiences of implementing a Generation Adapter.

A sample implementation is the project org.eclipse.emf.examples.generator.validator

(See git.eclipse.org/gitroot/emf under org.eclipse.emf/org.eclipse.emf/examples, or on the web interface)


[edit] GeneratorAdapter Class

The definition links like this

public class GenClassValidatorGeneratorAdapter extends GenBaseGeneratorAdapter
{

The GenBaseGeneratorAdapter base class provide you the basic implementation you have to override:

  • canGenerate
  • generateXXXX

It's depend of the project type what generate method's you override. The following types you know from the menu in the Gen Model.

  • MODEL_PROJECT_TYPE
  • EDIT_PROJECT_TYPE
  • EDITOR_PROJECT_TYPE
  • TESTS_PROJECT_TYPE

In the method canGenerated you have to return true for your project types.

The prefix "GenClass" says this adapter works with the GenClass class of the genmodel, but this is just a naming convention .

In accordance to this you have to configure the extension point or you write a GeneratorAdapterFactory. All adapters types are:

  • GenPackage Adapter
  • GenEnum Adapter
  • GenModel Adapter
  • GenClass Adapter

Take care not all combinations and of project type and adapter type produce output. (e.g. I had no luck in the combination GenClass and EDITOR project)

[edit] Package Generator Adapter

If you write a GenPackage generator adapter you should verify in your generate method (in most cases) if it is required to generate an e.g. new class for it. The package in the model may on a higher level, but you get a call for all (selected) packages in the model.

if (genPackage.hasConcreteClasses()) {
  message = "Generating class XYZ"; /
  monitor.subTask(message);
 
   generateJava(....);
} else {
  monitor.worked(1);
}

A good example is the class GenPackageGeneratorAdapter of EMF itself, you can find it simply by the "Open Type..." command.

[edit] Dynamic Templates & Generator Adapter

To combine a Generator Adapter and a Dynamic Templates you can add the following URI in the GemModel "Template Directory" property

  • platform:/plugin/<plugin-id>/templates

If you have some problems during generation (e.g. it generate still the old version) it may help to remove the (hidden) project ".JETEmitter" from you testing workspace (if you just delete it don't forget to refresh the workspace)

[edit] JET Templates

The included JET Templates or better the static JET template classes have to be generated with the "old/basic" JET implementation. (choose "Convert Project to JET Project" in new wizard and do not create a "JET Transformation Project")

The M2T JET project even in JET 1 mode produces a not compatible code: see BUG 333811

[edit] Links

Forum entries related to how to combine a generator and dynamic templates

Here another example: http://code.google.com/a/eclipselabs.org/p/emf/source/browse/#hg%2Forg.eclipselabs.emf.codegen.addon