Générer des classes Java avec Acceleo en 5 minutes

Nous utilisons pour cet article Eclipse Modeling Tools (version Indigo) que vous pouvez télécharger ici. Cette distribution d'Eclipse ne contient pas le plugin Acceleo. Nous montrons dans la suite comment procéder à son installation.

I-A. Méthode 1▲

Acceleo peut être installé sous Eclipse Modeling Tools en allant dans :

• Help -> Install Modeling Components ;

• Sélectionner Acceleo ;

• Suivre les écrans suivants ;

• Finalement, il vous sera demandé de redémarrer Eclipse pour que l'installation d'Acceleo prenne effet.

I-B. Méthode 2▲

Il est aussi possible d'installer Acceleo à partir du site de mise à jour en suivant les étapes suivantes :

• Help -> Install New Software... ;
• Copier le lien suivant dans le champ de texte situé en haut de la boite de dialogue : http://download.eclipse.org/modeling/m2t/acceleo/updates/releases/3.1 ;

• Suivre les écrans suivants ;

• Redémarrer Eclipse pour que l'installation d'Acceleo prenne effet.

Dans cette section, nous créons un projet Acceleo que nous utilisons pour créer un template nous permettant de générer du code Java à partir d'un modèle Ecore.

• File -> New -> … -> Acceleo Project ;
• Entrer le nom du nouveau projet ;
• Choisir son emplacement -> Finish ;

• Créer votre modèle source (en UML ou Ecore par exemple) et nommer le fichier education.ecore;

• Créer un nouvel Acceleo Module File ;

• Choisir son emplacement dans « Parent Folder » ;
• Entrer le nom du module (genJava par exemple) ;
• Ajouter l'URI du méta-modèle de votre modèle. Dans notre cas, c'est l'URI du méta-modèle de Ecore qui est ajoutée ;
• Entrer le nom du template (genClass par exemple) ;
• Choisir le type principal à manipuler dans le template (dans notre cas cela correspondra à EClass) ;
• Cocher la case « Generate file » car notre template doit comporter un block [file] qui permettra de générer les fichiers de classes java ;
• Cocher aussi « Main template » car nous utilisons ce template comme template principal et il sera le point d'entrée de l'exécution de notre programme de génération de code.

Maintenant nous allons écrire un programme qui permet de générer du code Java à partir de notre modèle Ecore préalablement créé.

Notre objectif est de transformer les EClass en classes java, les EAttribute et EReference en propriétés de classes, les EOperation en méthodes java, et finalement générer les méthodes set et get relatives aux propriétés de classes.

Pour ce faire, Acceleo fournit un pseudo langage à balises où l'emploi des crochets [ ... ] est utilisé pour l'insertion de fonctionnalités spécifiques à Acceleo. Ainsi, tout texte en dehors des crochets sera interprété comme une simple chaîne de caractères.

[comment encoding = UTF-8 /]
[module genJava('http://www.eclipse.org/emf/2002/Ecore')]


[template public genClass(aEClass : EClass)]
[comment @main/]
[file (aEClass.name.concat('.java'), false, 'UTF-8')]
[comment][/comment]
public class [aEClass.name/] {

[for (aEAttribute : EAttribute | aEClass.eAllAttributes)]
    [aEAttribute.eType.instanceClassName/] [aEAttribute.name/];
[/for]

[for (aEReference : EReference | aEClass.eAllReferences)]
    [aEReference.eReferenceType.name/] [aEReference.name/];
[/for]

[for (aEAttribute : EAttribute | aEClass.eAllAttributes)]
    public [aEAttribute.eType.instanceClassName/] get[aEAttribute.name.toUpperFirst()/] () {
        return this.[aEAttribute.name/];
    }
[/for]

[for (aEAttribute : EAttribute | aEClass.eAllAttributes)]
    public void set[aEAttribute.name.toUpperFirst()/] ([aEAttribute.eType.instanceClassName/] [aEAttribute.name/]) {
        this.[aEAttribute.name/] = [aEAttribute.name/];
    }
[/for]

[for (aEReference : EReference | aEClass.eAllReferences)]
    public [aEReference.eReferenceType.name/] get[aEReference.name.toUpperFirst()/] () {
        return this.[aEReference.name/];
    }
[/for]

[for (aEReference : EReference | aEClass.eAllReferences)]
    public void set[aEReference.name.toUpperFirst()/] ([aEReference.eReferenceType.name/] [aEReference.name/]) {
        this.[aEReference.name/] = [aEReference.name/];
    }
[/for]

[for (aEOperation : EOperation | aEClass.eAllOperations)]
    public [aEOperation.eType.instanceClassName/] [aEOperation.name/] () {
    //TODO
    }
[/for]

}
[/file]
[/template]

Si vous êtes habitués à des moteurs de template comme FreeMarker ou Apache Velocity vous ne serez pas dépaysés par cette approche. Toutefois, l'originalité d'Acceleo est de s'appuyer sur EMF pour l'extraction des données.

Configurer l'exécution du template. Notamment, choisir le modèle source (champ Model) et l'emplacement (champ Target) où seront stockées les classes générées.

Ainsi, nous obtenons les classes générées dans le répertoire generated. Elles sont au nombre de trois (Course, Student et Take_Course) comme exprimées dans le modèle EMF.

Ce premier article se veut être une courte introduction des possibilités offertes par Acceleo pour la génération de code. Nous souhaitons dans un prochain article fournir une description détaillée de la syntaxe employée pour décrire un template.

Nous tenons à remercier _Max_ pour sa relecture orthographique et gueritarish pour sa relecture technique..