Difference between revisions of "EEF/User Guide/Custom Widget Generation"

Revision as of 10:49, 6 February 2012 (view source) Goulwen.lefur.obeo.fr (Talk | contribs) (→‎Generating PropertiesEditionPart) ← Older edit		Revision as of 10:57, 6 February 2012 (view source) Goulwen.lefur.obeo.fr (Talk | contribs) (→‎Creating Acceleo modules to generate a specific widget with EEF) Newer edit →
Line 54:		Line 54:
	[[Image:9 - EEF CostumGen GettersSettersDynamicCode.png]]		[[Image:9 - EEF CostumGen GettersSettersDynamicCode.png]]
		+
		+	In this example, we've used the <pre>getterSignature()</pre> and the <pre>setterSignature()</pre> templates which generate the getter and setter signatures for the given ElementEditor. We've also used the <pre>elementEditorName()</pre> template which refers to the name of the field in the generated views. In order to find this services you can browse the ''services'' package in the EEF generation project.

---

Revision as of 10:57, 6 February 2012

Need to generate new widgets ?

In the CustomElementEditor guide, we saw how to ponctually include specific widgets in EEF generated editing forms. If this need is becoming common, EEF offers the ability to extend its generators to generate new widgets.

Environment initialization

As we will create acceleo generator, we need to install the Acceleo SDK. It can be done via the release train:

Next, in an empty workspace, we create an Acceleo Project. In the new project wizard, we can initialize our first template:

Let's name it spinnerGettersSetter. It need two metamodels:

• http://www.eclipse.org/emf/eef/components/1.0.0
• http://www.eclipse.org/emf/eef//views/1.0.0

The other data are marginal, we will erase the generated body of this module.

We also have to add to the generator project a dependency to the EEF Codegen plugin : org.eclipse.emf.eef.codegen.

And finally, we add an Extension to the generator project. The org.eclipse.acceleo.engine.dynamic.templates defines a project as an dynamic module able to extend existing generators. In this extension, we must specify the folders containing dynamic modules. In our case, we can specify the folder org/eclipse/emf/samples/eef/gen/spinner/common.

After these step, we can create our modules to generate spinner with EEF.

Creating Acceleo modules to generate a specific widget with EEF

In the CustomElementEditor guide, we modified 4 classes in the code generated by EEF in order to add manually a specific widget in an EEF editing form. To generate a specific widget, we have to create 4 generation modules.

Generating PropertiesEditionPart

The first module is the "GettersSetters" module defining the methods' signature for the views interfaces and their implementations in the PartImpls and the PartForms. In our case, we just have to override the generation in order to define the getters and setters implementations. We have to override two templates from the abstract module widgetGettersSetters :

• getterSignatureImplementation
• setterSignatureImplementation

To do that, you can use the override view in Acceleo :

This view initialize the two templates to implement :

The easiest way to defines your templates is to copy the code from an existing example and to copy it into the templates:

Then you can replace the dynamic part of this code by an Acceleo dynamic code area:

In this example, we've used the

getterSignature()

and the

setterSignature()

templates which generate the getter and setter signatures for the given ElementEditor. We've also used the

elementEditorName()

template which refers to the name of the field in the generated views. In order to find this services you can browse the services package in the EEF generation project.