Acceleo 2.6 : Référence

Acceleo 2.6 : Référence 

Page 1/112

ACCELEO 

Référence 


Page 2/112 

Ce manuel est la propriété exclusive de ses auteurs et a été concédé par ces derniers au profit de la société 

OBEO, SARL au capital de 45.000 € dont le siège social est sis 2 rue Robert Schuman, 44400 Rezé, inscrite 

au Registre du Commerce et des sociétés de NANTES sous le numéro 485.129.860. 

Ce manuel est protégé au titre des dispositions légales et réglementaires régissant les droits de propriété 

intellectuelle. Il traite d’un produit logiciel dénommé ACCELEO, actuellement distribué sous licence open 

source EPL par la société OBEO. Ce manuel a été fait avec la plus grande attention. Toutefois, des erreurs 

ont pu se glisser dans la version de ce manuel. OBEO ne peut être, en aucun cas, tenue pour responsable 

des suites que ces erreurs pourraient entraîner. 

La distribution de ce manuel n’est pas libre. Ce manuel peut-être téléchargé gratuitement après 

enregistrement sur le site de la société OBEO, et peut-être consulté dans le cadre d'une utilisation 

commerciale ou non de la technologie ACCELEO. Cependant, la copie, la traduction et la redistribution de 

ce document sur support électronique ou sur papier nécessite une autorisation de la part de OBEO. 

Nous rappelons à votre attention que les dispositions légales régissant les conditions d’utilisation et de 

distribution de ce manuel sont regroupées au sein du Code de la Propriété Intellectuelle, notamment dans 

son Titre II – Droits des auteurs (Articles L121-1 à L123-12). 

Nous nous réservons le droit de modifier sans avis préalable ce manuel ou le produit. 

Merci de respecter ces dispositions. 

________________ 

« OBEO », « ACCELEO », ainsi que les logos OBEO et ACCELEO associés à ce manuel sont déposés par 

OBEO SARL en France et/ou dans d'autres pays du monde. 

Tous les autres noms, titres, dessins, et logos sont la propriété exclusive de leurs auteurs respectifs et sont 

protégés au titre des droits de propriété intellectuelle. 

Ce manuel a été rédigé avec les outils suivants : OpenOffice 

Auteurs : Jonathan MUSSET, Etienne JULIOT, Stéphane LACRAMPE 

avec la participation de : Goulwen LE FUR, Julien DUPONT, Guillaume RAIMBAULT, Nathalie LEPINE, 

William PIERS, Cédric BRUN, Freddy ALLILAIRE, et Laurent GOUBET 

© Copyright 2006-2008 Obeo. Tous droits réservés

Table des matières 


Page 3/112 

1 - Introduction.......................................................................................................................7 

1.1 - Connaissances minimales requises..........................................................................7 

2 - Les éléments de syntaxe..................................................................................................8 

2.1 - comment....................................................................................................................8 

2.2 - metamodel.................................................................................................................8 

2.3 - import.........................................................................................................................8 

2.4 - script..........................................................................................................................9 

2.5 - for...............................................................................................................................9 

2.6 - if...............................................................................................................................10 

3 - Liste des services...........................................................................................................11 

3.1 - ContextServices......................................................................................................11 

3.1.1 - get.....................................................................................................................12 

3.1.2 - peek..................................................................................................................13 

3.1.3 - pop....................................................................................................................14 

3.1.4 - push..................................................................................................................15 

3.1.5 - put.....................................................................................................................16 

3.2 - ENodeServices........................................................................................................17 

3.2.1 - adapt................................................................................................................18 

3.2.2 - cast...................................................................................................................19 

3.2.3 - current..............................................................................................................20 

3.2.4 - current..............................................................................................................21 

3.2.5 - debug...............................................................................................................22 

3.2.6 - filter...................................................................................................................23 

3.2.7 - minimize...........................................................................................................24 

3.2.8 - nContains.........................................................................................................25 

3.2.9 - nFirst................................................................................................................26 

3.2.10 - nGet................................................................................................................27 

3.2.11 - nGet................................................................................................................28 

3.2.12 - nGet................................................................................................................29 

3.2.13 - nLast...............................................................................................................30 

3.2.14 - nMinimize.......................................................................................................31 

3.2.15 - nPeek.............................................................................................................32 

3.2.16 - nPop...............................................................................................................33 

3.2.17 - nPush.............................................................................................................34 

3.2.18 - nPut................................................................................................................35 

3.2.19 - nReverse........................................................................................................36


Page 4/112 

3.2.20 - nSize..............................................................................................................37 

3.2.21 - nSort...............................................................................................................38 

3.2.22 - nSort...............................................................................................................39 

3.2.23 - reverse...........................................................................................................40 

3.2.24 - sep..................................................................................................................41 

3.2.25 - sepStr.............................................................................................................42 

3.2.26 - sort.................................................................................................................43 

3.2.27 - sort.................................................................................................................44 

3.2.28 - toString...........................................................................................................45 

3.2.29 - trace...............................................................................................................46 

3.2.30 - trace...............................................................................................................47 

3.2.31 - until.................................................................................................................48 

3.3 - EObjectServices .....................................................................................................50 

3.3.1 - eAllContents.....................................................................................................51 

3.3.2 - eAllContents.....................................................................................................52 

3.3.3 - eClass..............................................................................................................53 

3.3.4 - eContainer........................................................................................................54 

3.3.5 - eContainer........................................................................................................55 

3.3.6 - eContainingFeature..........................................................................................56 

3.3.7 - eContainmentFeature......................................................................................57 

3.3.8 - eContents.........................................................................................................58 

3.3.9 - eCrossReferences...........................................................................................59 

3.3.10 - eResource......................................................................................................60 

3.3.11 - eResourceName............................................................................................61 

3.3.12 - getRootContainer...........................................................................................62 

3.3.13 - load.................................................................................................................63 

3.4 - PropertiesServices..................................................................................................64 

3.4.1 - getBestProperty................................................................................................65 

3.4.2 - getProperty.......................................................................................................66 

3.4.3 - getProperty.......................................................................................................67 

3.5 - RequestServices ....................................................................................................68 

3.5.1 - delete................................................................................................................69 

3.5.2 - delete................................................................................................................70 

3.5.3 - evaluate............................................................................................................71 

3.5.4 - select................................................................................................................72 

3.5.5 - select................................................................................................................73 

3.6 - ResourceServices...................................................................................................74


Page 5/112 

3.6.1 - getFileContent..................................................................................................75 

3.6.2 - getChainPath....................................................................................................76 

3.7 - SpecialsServices.....................................................................................................77 

3.7.1 - i.........................................................................................................................78 

3.7.2 - args...................................................................................................................79 

3.8 - StringServices ........................................................................................................80 

3.8.1 - charAt...............................................................................................................81 

3.8.2 - endsWith..........................................................................................................82 

3.8.3 - equalsIgnoreCase............................................................................................83 

3.8.4 - indentSpace.....................................................................................................84 

3.8.5 - indentTab.........................................................................................................85 

3.8.6 - indexOf.............................................................................................................86 

3.8.7 - indexOf.............................................................................................................87 

3.8.8 - lastIndexOf.......................................................................................................88 

3.8.9 - lastIndexOf.......................................................................................................89 

3.8.10 - length..............................................................................................................90 

3.8.11 - matches..........................................................................................................91 

3.8.12 - replaceAll........................................................................................................92 

3.8.13 - replaceFirst.....................................................................................................93 

3.8.14 - split.................................................................................................................94 

3.8.15 - startsWith.......................................................................................................95 

3.8.16 - substring.........................................................................................................96 

3.8.17 - substring.........................................................................................................97 

3.8.18 - toL1Case........................................................................................................98 

3.8.19 - toLowerCase..................................................................................................99 

3.8.20 - toU1Case.....................................................................................................100 

3.8.21 - toUpperCase................................................................................................101 

3.8.22 - trim...............................................................................................................102 

3.9 - XpathServices.......................................................................................................103 

3.9.1 - ancestor..........................................................................................................104 

3.9.2 - child................................................................................................................105 

3.9.3 - descendant.....................................................................................................106 

3.9.4 - following.........................................................................................................107 

3.9.5 - followingSibling..............................................................................................111 

3.9.6 - parent.............................................................................................................112 

3.9.7 - preceding........................................................................................................113 

3.9.8 - precedingSibling.............................................................................................114


Page 6/112 

3.9.9 - self..................................................................................................................115

1 - Introduction 


Page 7/112 

Ce document est une présentation détaillée de la syntaxe et des services de l'outil de génération de code 

Acceleo, initié par la société Obeo. 

Ce générateur de code est dédié aux personnes qui veulent tirer profit des technologies MDA pour 

accroître la productivité de leurs développements informatiques. Il permet de générer des fichiers à partir 

de modèles UML, MOF, EMF... 

Il s'agit d'un plugin caractérisé par : 

– Son intégration complète à l'environnement Eclipse et au framework EMF 

– La gestion de la synchronisation entre le code et le modèle 

– La génération incrémentale 

– La simplicité d'adaptation à tout type de cible technique 

– La facilité de mise au point et de maintenabilité des templates 

– La colorisation syntaxique, la complétion, la détection d'erreurs 

Ce document de référence s'inscrit dans un ensemble de documentations proposées par la société Obeo. 

Chaque documentation aborde une facette différente de la maîtrise d'Acceleo : 

– guide utilisateur : documentation des fonctionnalités d'Acceleo 

– tutoriel utilisateur : prise en main d'Acceleo 

– tutoriel architecte : guide pour la création et la personnalisation de modules de génération 

1.1 - Connaissances minimales requises 

Ce présent guide ne se veut pas être une formation pour l'ensemble des problématiques couvertes par le 

MDA et Acceleo en particulier. Ainsi, la lecture de ce guide requiert les connaissances suivantes : 

– Java 

– modélisation (par exemple : UML) 

– utilisation d'Eclipse 

La connaissance des concepts suivants sera également un plus, mais ne sera pas indispensable à la 

lecture de cette documentation : 

– méta-modèles 

– méta-modèle UML2 

– développement de plugins Eclipse 

– MDA ou MDD

2 - Les éléments de syntaxe 


Page 8/112 

Les parties variables des scripts de génération sont délimitées par les balises . Cependant pour 

des raisons de conflits (par exemple, avec les balises du langage JSP), il est possible d'utiliser les balises 

[% et %]. Ce choix se fait dynamiquement en fonction de la première balise du fichier, celle de la section 

“ import ” (cf. Guide de l'utilisateur). 

2.1 - comment 

Il est possible de commenter les scripts de génération en insérant des explications d'une ou plusieurs 

lignes entre les balises (ou [% - - et - - %]). 

2.2 - metamodel 

Le mot clé “ metamodel ” permet de définir le méta modèle utilisé dans le script de génération. L'instruction 

est la première de la section import (cf. Guide de l'utilisateur). La syntaxe de cette instruction est : 

 

où URIDeMonMetamodèle est l'URI qui identifie le méta modèle utilisé. Les principales URI utilisées sont : 

– méta modèle UML 1.4 : http://www.obeo.fr/uml14 

– méta modèle UML 1.3 : http://www.obeo.fr/uml13 

– méta modèle UML 2.0 : http://www.eclipse.org/uml2/1.0.0/UML ou http://www.eclipse.org/uml2/2.0.0/UML 

– méta modèle Ecore : http://www.eclipse.org/emf/2002/Ecore 

Exemples d'utilisation : 

 

Cette section d'import définit que le méta modèle utilisé par les scripts de ce fichier est le métamodèle UML 1.4. 

2.3 - import 

L'instruction “ import ” est utilisée dans la section import (cf. Guide de l'utilisateur) d'un script de génération. 

Cette instruction permet de faire un lien vers un autre template ou un fichier de service. Il est dès lors 

possible d'appeler les scripts ou les services de ce fichier. Le concept sous-jacent à cette instruction est 

semblable à celui de la notion “ import ” dans le langage Java. La syntaxe de cette instruction est :


Page 9/112 

où monPackage est le chemin du fichier (exemple : “ fr.obeo.acceleo ”), maClassDeServices est le nom de 

la classe Java où j'ai défini mes propres services et monTemplateDeScripts est le nom du template dans 

lequel se trouve les scripts de génération que j'ai écrit. 

Exemples d'utilisation 

 

Cette section d'import explique que les scripts de ce fichier peuvent utiliser les scripts définis dans le fichier 

“ commonScript.mt ” ainsi que les services de la classe “ StringServices.java ”. 

2.4 - script 

La balise “ script ” permet d'identifier le script de génération et le type d'objet sur lequel il s'applique. La 

syntaxe de cette balise est : 

 

où monType est le type d'objet sur lequel s'applique le script (“ Package ”, “ Class ”, “ Attribute ”, ...), 

identifiant est une chaîne de caractères qui identifie le script, nomDuFichierGénéré est une chaîne de 

caractères qui correspond au chemin d'accès du fichier produit lors de la génération (extension comprise), 

maDescription est une chaîne de caractères qui décrit l'action du script, et monPost est un traitement 

appelé pour le résultat de l'évaluation du template. 

Les paramètres “ type ” et “ name ” sont obligatoires. Les paramètres “ file ”, “ description ”, et ”post” sont 

optionnels. 

Le couple de paramètres (“ type ”, “ name ”) est l'identifiant du script. Pour un type donné, les noms de 

chaque script doivent être différents. 

Le paramètre “ file ” peut contenir l'appel à un autre script qui se charge de la génération du chemin d'accès 

du fichier à générer (cf. Exemples d'utilisation). 


 

Ici sont toutes les instructions de mon script “ generate ”. 

 

src/monPackage/monSousPackage/monNomDeFichier.java 

Dans cet exemple, un fichier nommé “ monNomDeFichier.java ” est enregistré dans le répertoire nommé 

“ monSousPackage ”, lui même contenu dans le répertoire “ monPackage ” du répertoire “ src ” du projet. Ce fichier 

contiendra le texte suivant : “ Ici sont toutes les instructions de mon script “ generate ”. ”. 

2.5 - for 

L'instruction “ for ” est l'implémentation d'une boucle. La syntaxe de cette instruction est : 

 

instructions exécutées sur chaque élément de maListeDObjets. 


Page 10/112 

où maListeDObjets est une liste au sens Acceleo du terme (type “ ENodeList ”) d'objets au sens Acceleo 

(entier (“ int ”), booléen (“ boolean ”), chaîne de caractères (“ String ”), liste (“ ENodeList ”) ou objets 

(“ EObject ”)). 


 

Le nom de la classe est : . 

 

Cet exemple génère pour chacune des classes contenues dans l'objet courant : “ Le nom de la classe est : 

NomDeLaClasse. ” où NomDeLaClasse est le nom de la classe de l'itération courante. 

2.6 - if 

L'instruction “ if ” permet de tester une condition. La syntaxe de cette instruction est : 

 

instructions exécutées si expressionBooléenne est vrai 

 

instructions exécutées sinon (expressionBooléenne est faux) 

 

où expressionBooléenne est une instruction qui fournit un booléen. Il est possible d'utiliser ces différents 

opérateurs : == (égal), != (différent), < (strictement inférieur), (strictement 

supérieur), >= (supérieur ou égal), || (disjonction), && (conjonction) et ! (négation). Les opérandes sont des 

valeurs, des objets et des appels à des scripts, à des services ou à des liens de méta modèles. 

Exemples d'utilisation 

 

public List myList = new ArrayList(); 

 

public String myString = “”; 

 

Cet exemple génère “ public List myList = new ArrayList(); ” si l'objet courant à le stéréotype “ Entity ” sinon il génère 

“ public String myString = “” ”.

3 - Liste des services 


Page 11/112 

ENode est un type abstrait de donnée défini par Acceleo qui sert à encapsuler une valeur. Il s'adapte à tous 

les types d'objets voulus dans les services : entier (int), booléen (boolean), chaîne de caractères (String), 

liste (ENodeList) ou objet (EObject). Grâce à ce type, les exceptions Java “ NullPointerException ” et 

“ OutOfBoundException ” ne sont pas levées mais un objet vide est renvoyé. Ainsi, l'enchaînement d'appels 

des méthodes est toujours possible. 

EObject est l'équivalent en EMF de la classe java.lang.Object dans le langage Java, c'est la base de toutes 

les classes EMF. 

3.1 - ContextServices 

Cette classe regroupe les services utilisant le contexte et la pile. Ces services sont appelés en priorité car 

ils s'appliquent sur n'importe quel type d'objet. L'implémentation de ces services doit prendre en compte 

tous les cas possibles d'objets. 

Nombre de services inclus : 5 

Disponibilité : Acceleo v2.0

3.1.1 - get 

get(String) 

Renvoie l'objet référencé par la clé donnée en paramètre dans le contexte. 

Receveur 

Paramètre 

Retour 

Disponibilité 

Description détaillée 


Page 12/112 

ENode, c'est à dire tous les types d'objets (int, double, boolean, String, ENodeList, 

EObject) 

String key : la clé qui référence l'objet. 

L'objet référencé par la clé key du contexte. 

Acceleo V2.0 

Le service “ get ” permet de récupérer un objet identifié par la clé key dans le contexte du script. Il simule la 

récupération d'une variable stockée sous la forme (clé, valeur). Il permet de récupérer un objet posé par le 

service “ put ” dans le contexte. Le contexte s'étend sur le script courant ainsi que sur tous les scripts 

auxquels il fait appel. 

Par exemple, pour un calcul compliqué et coûteux en temps, il permet de ne calculer qu'une seule fois la 

valeur d'un objet, qui après avoir été référencée dans le contexte peut être récupérée. 

Si la clé ne référence aucun objet, il renvoie un objet vide. 

Exemple(s) d'utilisation 

Si on écrit dans le code , une chaîne de caractère vide est générée et 

« monObject » est stocké. 

A un autre endroit dans le code, pour générer le nom de “ monObjet ”, il faut écrire . 

Voir aussi 

put()

3.1.2 - peek 

peek() 

Renvoie l'objet au sommet de la pile du contexte. 

Receveur 

Retour 




Page 13/112 


EObject) 

Le sommet de la pile si elle n'est pas vide, sinon une chaîne vide. 


Le service “ peek ” renvoie le sommet de la pile du contexte. Le contexte s'étend sur le script courant ainsi 

que sur tous les scripts auxquels il fait appel. Il ne dépile pas le sommet. 

Si la pile est vide, il renvoie une chaîne vide. 


Soit a un objet, et les lignes suivantes dans un script (des instructions peuvent s'intercaler entre ces lignes), 

: On empile l'objet a, une chaîne de caractère vide est générés. 

: On récupère l'objet a mais on ne le dépile pas. On génère le nom de l'objet a. 

: On récupère toujours a. Cette fois ci, on génère le type de l'objet a. 

: On dépile a mais on ne récupère rien. Une chaîne de caractère vide est générée. 

: La pile étant vide, on récupère un objet vide. 

Voir aussi 

push(), pop()

3.1.3 - pop 

pop() 

Dépile le sommet de la pile du contexte. 

Receveur 

Retour 



Page 14/112 


EObject) 

rien 



Le service “ pop ” dépile le sommet de la pile du contexte. Le contexte s'étend sur le script courant ainsi 

que sur tous les scripts auxquels il fait appel. Il ne renvoie pas l'objet stocké au sommet. Une chaîne vide 

est générée à l'endroit où il est appelé. 


Soient a, b, c des objets et les instructions suivantes (d'autres instructions peuvent être ajoutées entre ces lignes) : 

: la pile est a. 

: la pile est a | b. 

: la pile est a. On ne récupère pas b. On génère une chaîne de caractères vide. 

: la pile est a | c. 

: la pile est a. On ne récupère pas c. On génère une chaîne de caractères vide. 

: la pile est vide. On ne récupère pas a. On génère une chaîne de caractères vide. 

Voir aussi 

push(), peek()

3.1.4 - push 

push() 

Empile le receveur sur la pile du contexte. 

Receveur 

Retour 



Page 15/112 


EObject) 

rien 



Le service “ push ” empile le receveur sur la pile du contexte. Le contexte s'étend sur le script courant ainsi 

que sur tous les scripts auxquels il fait appel. Une chaîne vide est générée à l'endroit où il est appelé. 



: On empile a. On génère une chaîne de caractère vide. 

: la pile est a | b. On génère une chaîne de caractère vide. 


: la pile est a | c. On génère une chaîne de caractère vide. 



Voir aussi 

pop(), peek()

3.1.5 - put 

put(String) 

Stocke le receveur dans le contexte avec comme identifiant la clé donnée en paramètre. 

Receveur 

Paramètre 

Retour 



Page 16/112 


EObject) 

String key : la clé identifiant l'objet recherché. 

rien 



Le service “ put ” stocke le receveur sous la forme (clé, valeur) dans le contexte. Le contexte s'étend sur le 

script courant ainsi que sur les scripts auxquels il fait appel. On récupère cet objet à partir de la sa clé 

grâce au service “ get ”. 


Si on écrit dans le code , on enregistre dans le contexte du script et sous 

l'identifiant “ idDeMonObjet ”, l'objet “ monObjet ”. Une chaîne de caractère vide est générée. 


Voir aussi 

get()

3.2 - ENodeServices 


Page 17/112 

Cette classe regroupe les services ENodeServices. Ces services sont appelés en priorité car ils 

s'appliquent sur n'importe quel type d'objet. L'implémentation de ces services doit prendre en compte tous 

les cas possibles d'objets. 



3.2.1 - adapt 

adapt(String) 

Renvoie le receveur adapté au type donné en paramètre. 

Receveur 

Paramètre 

Retour 




Page 18/112 


EObject) 

String type : le type de l'objet voulu (Eobject, String, boolean, int, double, List, 

ENodeList). 

L'élement adapté au type. 


Le service “ adapt ” renvoie un objet qui a le type donné en paramètre. 

S'il est appelé sur un receveur vide, il renvoie un objet vide. 


 

La chaîne de caractères " 1234 " est adpatée en entier 1234.

3.2.2 - cast 

cast(String) : obsolète 


Page 19/112 

Renvoie tous les objets du receveur qui ont le type donné en paramètre. Identique au service filter.. 

Receveur 

Paramètre 

Retour 




EObject) 

String type : le type des objets recherchés. 

Une liste contenant les objets du type donné. 


Le service “ cast ” renvoie seulement les objets qui ont le type donné en paramètre. Les objets sont gardés si ce sont 

des “ EObject ” du type donné ou si ce ne sont pas des “ EObject ”. La notion est proche de celle de “ cast ” dans le 

langage Java. 

S'il est appelé sur un receveur vide, il renvoie un objet vide. S'il est appelé sur un receveur autre qu'une liste, il renvoie 

le receveur s'il est du type donné en paramètre sinon un objet vide. 

Obsolète : utiliser filter(String). 


1 er 

exemple : 

– a est une instance de A 

– b est une instance de B 

– c est une instance de C 

– B hérite de A 

Si le type donné est A sur une liste d'objet {a, “ \n ”, b, c}, le résultat est {a, “ \n ”, b} 

2 ème 

exemple : 

 

Avec le service “ eAllContents ” on récupère la liste de tous les objets enfants du receveur. Sur cette liste, on ne garde 

que les objets de type “ Class ” ou dont le type hérite de “ Class ”. 

Voir aussi 

adapt(), filter()

3.2.3 - current 

current() 

Renvoie l'objet courant. 

Receveur 

Retour 




Page 20/112 


EObject) 

L'objet courant 


Le service “ current ” renvoie l'objet courant. Il rend explicite le receveur lors de l'appel d'un service. Il peut 

être comparée au “ this” du langage Java. 

Le receveur peut être implicite comme dans un script ou dans une boucle. Dans un script, ce service 

renvoie l'objet concerné par le script (). Dans les boucles (), il 

permet de récupérer l'objet de l'itération courante. 

Ce service peut être utilisé pour une comparaison avec l'objet de la requête. 

Si le receveur est vide, il renvoie un objet vide. 


 

 

 

Dans cette boucle “ for ” on ne travaille que sur les attributs contenus dans le receveur. On ne génère que le nom des 

classes qui s'appellent exactement comme l'attribut de l'itération courante. Si le modèle contient les classes de nom 

“ nom1 ”, “ nom2 ” et “ nom3 ” ainsi que les attributs “ nom2 ”, “ nom3 ” et “ nom4 ”, il ne sera généré que “ nom2 ” et 

“ nom3 ”. 

Voir aussi 

current(ENode), self()

3.2.4 - current 

current(ENode) 


Receveur 

Paramètre 

Retour 




Page 21/112 


EObject) 

ENode level : le niveau dans la hiérarchie parente 



Le service “ current ” renvoie l'objet courant du niveau en paramètre dans la hiérarchie d'imbrication des 

" for ". Si le niveau est un entier i, le service renvoie le i ème parent du noeud courant. Current(0) correspond 

à current(), current(1) correspond à l'élément du for imbriqué précédent. Si le niveau est une chaîne de 

caractères, le service renvoie le parent qui a le niveau comme type. 

Ce service peut être utilisé pour une comparaison avec l'objet de la requête. 



 

 

 

 

 

 

 

== 

== 

current(0) représente les attributs, current(1) représente les classes, 

current(2) et current(“Package”) représentent les packages. 

Voir aussi 

current(), self()

3.2.5 - debug 

debug() 

Affiche une description sommaire de l'objet courant. 

Receveur 

Retour 




Page 22/112 


EObject) 



Le service “ debug ” affiche le type et la valeur du noeud courant. Il fait appel au service 

“ trace ”. 

Voir aussi 

trace(), trace(String)

3.2.6 - filter 

filter(String) 


Page 23/112 

Renvoie tous les objets du receveur qui ont le type donné en paramètre. Identique au service Cast. 

Receveur 

Paramètre 

Retour 




EObject) 

String type : le type des objets recherchés. 

Une liste contenant les objets du type donné. 


Le service “ filter ” renvoie seulement les objets qui ont le type donné en paramètre. Les objets sont gardés 

si ce sont des “ EObject ” du type donné ou si ce ne sont pas des “ EObject ”. Ce service agit comme un 

filtre sur une liste en fonction du type. 

S'il est appelé sur un receveur vide, il renvoie un objet vide. S'il est appelé sur un receveur autre qu'une 

liste, il renvoie le receveur s'il est du type donné en paramètre sinon un objet vide. 


1 er 

exemple : 

– a est une instance de A 

– b est une instance de B 

– c est une instance de C 

– B hérite de A 

Si le type donné est A sur une liste d'objet {a, “ \n ”, b, c}, le résultat est {a, “ \n ”, b} 

2 ème 

exemple : 

 

Avec le service “ eAllContents ” on récupère la liste de tous les objets enfants du receveur. Sur cette liste, on ne garde 

que les objets de type “ Class ” ou dont le type hérite de “ Class ”. 

Voir aussi 

cast()

3.2.7 - minimize 

minimize() : obsolète 

Supprime du receveur tous les objets dupliqués. 

Receveur 

Retour 




Page 24/112 


EObject) 

La liste des objets sans doublons 


Le service “minimize” renvoie une liste sans doublon. Chaque objet de la liste retournée est unique. Il utilise 

le service “ toString ” des objets pour la comparaison des objets. 

Si le receveur est vide, il renvoie un objet vide. S'il est appelé sur un receveur autre qu'une liste, il renvoie 

ce receveur. 

Obsolète : utiliser nMinimize(). 


Soit a, b, c, d, e des objets ENode. 

Sur une liste d'objets {a, a, b, b, b, c, d, e, e, e, e}, minimize() renvoie {a, b, c, d, e}. 

Voir aussi 

nMinimize, toString()

3.2.8 - nContains 

nContains(ENode) 

Indique si un élément est présent dans le receveur ou non. 

Receveur 

Paramètre 

Retour 




Page 25/112 


EObject) 

ENode element : l'élément recherché 

Vrai si la liste contient l'élément spécifié. 


Le service “ eContains ” renvoie un booléen qui indique si la liste courante contient l'objet 

passé en paramètre. 

Si le receveur est un objet autre qu'une liste, il compare celui-ci avec celui passé en 

paramètre grâce à la méthode “ equals ”. 


Sur une liste d'objet {a, b, c} : 

– nContains(a) renvoie “ true ” 

– nContains(d) renvoie “ false ”

3.2.9 - nFirst 

nFirst() 

Retourne le premier élément d'une liste. 

Receveur 

Retour 




Page 26/112 


EObject) 

Le premier élément de la liste courante. 


Le service “ nFirst ” renvoie le premier élément de la liste courante. Il appel le service 

“ nGet(0) ”. 

Si le receveur est un objet autre qu'une liste, alors il renvoie l'objet. 


Sur une liste d'objet {a, b, c}, le service renvoie a. 

Voir aussi 

nGet(int) , nLast()

3.2.10 - nGet 

nGet(String) : obsolète 

Renvoie l'objet référencé par la clé donnée en paramètre. 

Receveur 

Paramètre 

Retour 




Page 27/112 


EObject) 

String key : la clé qui référence l'objet. 

L'objet référencé par la clé key du contexte. 


Le service “ nGet ” permet de récupérer un objet identifié par la clé key dans le contexte du script. Il simule 

la récupération d'une variable stockée sous la forme (clé, valeur). Il permet de récupérer un objet posé par 

le service “ nPut ” dans le contexte. Le contexte s'étend sur le script courant ainsi que sur tous les scripts 

auxquels il fait appel. 

Par exemple, pour un calcul compliqué et coûteux en temps, il permet de ne calculer qu'une seule fois la 

valeur d'un objet, qui après avoir été référencée dans le contexte peut être récupérée. 

Si la clé ne référence aucun objet, il renvoie un objet vide. 

Obsolète : utiliser get(String). 


Si on écrit dans le code , une chaîne de caractère vide est générée et 

« monObject » est stocké. 


Voir aussi 

get(String), put()

3.2.11 - nGet 

nGet(int) 

Renvoie l'objet de la liste courante dont l'indice est donné en paramètre. 

Receveur 

Paramètre 

Retour 




Page 28/112 


EObject) 

int index : l'indice de l'objet recherché. 

L'objet à l'indice donné. 


Le service “ nGet ” renvoie l'objet du receveur à l'indice donné. 

Si le receveur est vide ou si l'indice est supérieur à la taille de la liste, il renvoie un objet vide. Si le receveur 

est un objet autre qu'une liste et que l'indice est 0, il renvoie l'objet. Si le receveur est un objet autre qu'une 

liste et que l'indice est différent de 0, il renvoie un objet vide. 


Dans un modèle contenant les classes “ c1 ”, “ c2 ” et “ c3 ”, “ eAllContents(“ Class ”) ” renvoie la liste de toutes ces 

classes. Si on écrit on génère le nom de la classe “ c1 ”. Si on écrit < 

%eAllContents(“ Class ”).nGet(1).name%> on génère le nom de la classe “ c2 ” et ainsi de suite...

3.2.12 - nGet 

nGet(int, int) 


Page 29/112 

Renvoie les objets de la liste courante dont les indices sont dans l'intervalle donné en paramètre. 

Receveur 

Paramètre 

Retour 




EObject) 

int begin : l'indice de début de l'objet recherché. 

Int end : l'indice de fin de l'objet recherché. 

Les objets dans l'intervalle donné. 


Le service “ nGet ” renvoie les objets du receveur de l'intervalle donné. 

Si le receveur est vide ou si l'indice est supérieur à la taille de la liste, il renvoie un objet vide. Si le receveur 

est un objet autre qu'une liste et que l'indice de début est 0, il renvoie l'objet. Si le receveur est un objet 

autre qu'une liste et que l'indice est différent de 0, il renvoie un objet vide. 


Dans un modèle contenant les classes “ c1 ”, “ c2 ” et “ c3 ”, “ eAllContents(“ Class ”) ” renvoie la liste de toutes ces 

classes. Si on écrit on génère le nom de la classe “ c1 ”. Si on écrit < 

%eAllContents(“ Class ”).nGet(1).name%> on génère le nom de la classe “ c2 ” et ainsi de suite...

3.2.13 - nLast 

nLast() 

Retourne le dernier élément d'une liste. 

Receveur 

Retour 




Page 30/112 


EObject) 

Le dernier élément de la liste courante. 


Le service “ nLast ” renvoie le dernier élément de la liste courante. Il appel le service 

“ nGet(int) ”, avec, en paramètre, la longueur de la liste diminuée de 1. 



Sur une liste d'objet {a, b, c}, le service renvoie c. 

Voir aussi 

nFirst(), nGet(int)

3.2.14 - nMinimize 

nMinimize() 

Supprime du receveur tous les objets dupliqués. 

Receveur 

Retour 




Page 31/112 


EObject) 

La liste des objets sans doublons 


Le service “nMinimize” renvoie une liste sans doublon. Chaque objet de la liste retournée est unique. Il 

utilise le service “ toString ” des objets pour la comparaison des objets. 

Si le receveur est vide, il renvoie un objet vide. S'il est appelé sur un receveur autre qu'une liste, il renvoie 

ce receveur. 


Soit a, b, c, d, e des objets ENode. 

Sur une liste d'objets {a, a, b, b, b, c, d, e, e, e, e}, nMinimize() renvoie {a, b, c, d, e}. 

Voir aussi 

toString()

3.2.15 - nPeek 

nPeek() : obsolète 

Renvoie l'objet au sommet de la pile du contexte. 

Receveur 

Retour 




Page 32/112 


EObject) 

Le sommet de la pile si elle n'est pas vide, sinon une chaîne vide. 


Le service “ nPeek ” renvoie le sommet de la pile du contexte. Le contexte s'étend sur le script courant ainsi 

que sur tous les scripts auxquels il fait appel. Il ne dépile pas le sommet. 

Si la pile est vide, il renvoie une chaîne vide. 

Obsolète : utiliser peek(). 


Soit a un objet, et les lignes suivantes dans un script (des instructions peuvent s'intercaler entre ces lignes), 

: On empile l'objet a, une chaîne de caractère vide est générés. 

: On récupère l'objet a mais on ne le dépile pas. On génère le nom de l'objet a. 

: On récupère toujours a. Cette fois ci, on génère le type de l'objet a. 

: On dépile a mais on ne récupère rien. Une chaîne de caractère vide est générée. 

: La pile étant vide, on récupère un objet vide. 

Voir aussi 

peek(), push(), pop()

3.2.16 - nPop 

nPop() : obsolète 

Dépile le sommet de la pile du contexte. 

Receveur 

Retour 



Page 33/112 


EObject) 

rien 



Le service “ nPop ” dépile le sommet de la pile du contexte. Le contexte s'étend sur le script courant ainsi 

que sur tous les scripts auxquels il fait appel. Il ne renvoie pas l'objet stocké au sommet. Une chaîne vide 

est générée à l'endroit où il est appelé. 

Obsolète : utiliser pop(). 



: la pile est a. 

: la pile est a | b. 


: la pile est a | c. 



Voir aussi 

pop(), push(), peek()

3.2.17 - nPush 

nPush() : obsolète 

Empile le receveur sur la pile du contexte. 

Receveur 

Retour 



Page 34/112 


EObject) 

rien 



Le service “ nPush ” empile le receveur sur la pile du contexte. Le contexte s'étend sur le script courant 

ainsi que sur tous les scripts auxquels il fait appel. Une chaîne vide est générée à l'endroit où il est appelé. 

Obsolète : utiliser push(). 



: On empile a. On génère une chaîne de caractère vide. 

: la pile est a | b. On génère une chaîne de caractère vide. 


: la pile est a | c. On génère une chaîne de caractère vide. 



Voir aussi 

push(), pop(), peek()

3.2.18 - nPut 

nPut(String) : obsolète 

Stocke le receveur dans le contexte avec comme identifiant la clé donnée en paramètre. 

Receveur 

Paramètre 

Retour 



Page 35/112 


EObject) 

String key : la clé identifiant l'objet recherché. 

rien 



Le service “ nPut ” stocke le receveur sous la forme (clé, valeur) dans le contexte. Le contexte s'étend sur 

le script courant ainsi que sur les scripts auxquels il fait appel. On récupère cet objet à partir de la sa clé 

grâce au service “ nGet ”. 

Obsolète : utiliser put(String). 


Si on écrit dans le code , on enregistre dans le contexte du script et sous 

l'identifiant “ idDeMonObjet ”, l'objet “ monObjet ”. Une chaîne de caractère vide est générée. 


Voir aussi 

put(String), get()

3.2.19 - nReverse 

nReverse() 

Retourne une liste dont ses éléments sont dans l'ordre inverse. 

Receveur 

Retour 




Page 36/112 


EObject) 

Une nouvelle liste avec ses élements inversés. 


Le service “nReverse ” renvoie la liste courante dans l'ordre inverse. 



Sur une liste d'objet {a, b, c}, le service renvoie {c, b, a}.

3.2.20 - nSize 

nSize() 

Renvoie la taille de l'objet. 

Receveur 

Retour 




Page 37/112 


EObject) 

La taille de l'objet. 


Le service “ nSize ” renvoie le nombre d'objets du receveur. Si le receveur est un objet quelconque, il 

renvoie 1. Si le receveur est un booléen ou un entier, il renvoie 1. Si le receveur est une liste, il renvoie la 

taille de la liste. Contrairement à ce qu'on pourrait penser, si le receveur est une chaîne de caractères, il 

renvoie le nombre de caractères de la chaîne et non 1. Si le receveur est vide, il renvoie 0. 


Il peut être utile de générer le nombre de classes d'un modèle dans un rapport. On peut récupérer ce nombre grâce à 

cette ligne de code : . Le service “ eAllContents ” renvoi une liste contenant toutes 

les classes du modèles. Le service “ nSize ” donne le nombre d'objets dans cette liste. 

Ce service peut aussi permettre de ne générer une méthode que si une classe contient au moins un attribut. Dans ce 

cas, cette méthode se trouvera entre les balises 0) {%> et .

3.2.21 - nSort 

nSort() 

Trie les objets du receveur. 

Receveur 

Retour 




Page 38/112 


EObject) 

La liste triée. 


Si le receveur est une liste, le service “ nSort ” trie les objets qu'elle contient en fonction de leur service 

“ toString ”. L'ordre se fait ensuite selon l'ordre des chaînes de caractères (les chiffres sont avant les 

lettres). Les entiers se retrouvent par conséquent avant les chaînes de caractères qui commencent par une 

lettre. Les doublons de la liste ne sont pas supprimés. 

Si le receveur est un objet, il renvoie cet objet. Si le receveur est vide, il renvoie un objet vide. 


Si le receveur est une liste d'objet dont les valeurs (résultat de la commande toString()} sont {“ class ”, “ attribute ”, “ 5 ”, 

“ stereotype ”, “ class ”}, le résultat est { “ 5 ”, “ attribute ”, "class", “ class ”, “ stereotype ”}. 

Voir aussi 

nSort(String)

3.2.22 - nSort 

nSort(String) 

Trie les objets d'une liste selon l'ordre indiqué par l'expression. 

Receveur 

Paramètre 

Retour 




Page 39/112 


EObject) 

String call : L'expression permettant de comparer chaque élément. 



Le service "nSort(String)" permet de comparer les éléments d'une liste selon l'ordre donné par une 

expression donnée en paramètre et de renvoyer cette liste triée. Les doublons ne sont pas supprimés. 

Si le receveur n'est pas une liste, il renvoie l'objet courant. 


Soit maListe la liste d'objets {d, a, c, f, b, e}, ces objets ayant pour nom {“class”, “attribute”, “5”, “stereotype”, “class”} 

retournera pour résultat { “ 5 ”, “ attribute ”, "class", “ class ”, “ stereotype ”}. 

Voir aussi 

nSort()

3.2.23 - reverse 

reverse() : obsolète 

Retourne une liste dont ses éléments sont dans l'ordre inverse. 

Receveur 

Retour 




Page 40/112 


EObject) 

Une nouvelle liste avec ses élements inversés. 


Le service “reverse ” renvoie la liste courante dans l'ordre inverse. 


Obsolète : utiliser nReverse(). 


Sur une liste d'objet {a, b, c}, le service renvoie {c, b, a}. 

Voir aussi 

nReverse()

3.2.24 - sep 

sep(String) 

Ajoute le séparateur donné entre chaque objet du receveur. 

Receveur 

Paramètre 

Retour 




Page 41/112 


EObject) 

String separator : le séparateur à ajouter. 

Une liste avec un séparateur entre chaque objet du receveur. 


Le service “ sep ” concatène un séparateur entre chaque objet du receveur si ce dernier est une liste. Si le 

receveur est un objet, il renvoie cet objet. Si le receveur est vide, il renvoie un objet vide. 


1 er 

exemple : 

Soit a, b et c des objets. 

Si on applique le service sep(“ \t ”) sur la liste d'objets {a, b, c}, il renvoie {a, “ \t ”, b, “ \t ”, c}. 

2 ème 

exemple : 

Pour générer une liste de paramètres dans une méthode avec une virgule après chaque paramètre, on peut écrire la 

suite d'instructions suivante : . Si les paramètres sont “ a ”, “ b ” et 

“ c ”, les instructions généreront : “ a, b, c ”.

3.2.25 - sepStr 

sepStr(String) : obsolète 

Ajoute une séparateur entre chaque élément d'une liste et sérialise le résultat. 

Receveur 

Paramètre 

Retour 




Page 42/112 


EObject) 

String separator : Le séparateur à concaténer entre chaque élément du receveur 

Une chaîne de caractère contenant un séparateur entre chaque élément 


Le service “ sep ” concatène un séparateur entre chaque objet du receveur si ce dernier est une liste. Si le 

receveur est un objet, il renvoie cet objet. Si le receveur est vide, il renvoie un objet vide. 

Obsolète : utiliser sep(String). 


Si le séparateur est “ t ” et que le receveur est la liste {a, b, c}, le résultat est une chaîne de caractères : “ a t b t c ”. 

Voir aussi 

sep(String)

3.2.26 - sort 

sort() : obsolète 

Trie les objets du receveur en supprimant les doublons. 

Receveur 

Retour 




Page 43/112 


EObject) 



Si le receveur est une liste, le service “ sort ” trie les objets qu'elle contient en fonction de leur service 

“ toString ”. L'ordre se fait ensuite selon l'ordre des chaînes de caractères (les chiffres sont avant les 

lettres). Les entiers se retrouvent par conséquent avant les chaînes de caractères qui commencent par une 

lettre. Les doublons de la liste sont supprimés. 

Si le receveur est un objet, il renvoie cet objet. Si le receveur est vide, il renvoie un objet vide. 

Obsolète : utiliser nSort(). 


Si le receveur est une liste d'objet dont les valeurs (résultat de la commande toString()} sont {“ class ”, “ attribute ”, “ 5 ”, 

“ stereotype ”, “ class ”}, le résultat est { “ 5 ”, “ attribute ”, “ class ”, “ stereotype ”}. 

Voir aussi 

nSort()

3.2.27 - sort 

sort(String) : obsolète 

Trie les objets d'une liste selon l'ordre indiqué par l'expression. 

Receveur 

Paramètre 

Retour 




Page 44/112 


EObject) 

String call : L'expression permettant de comparer chaque élément. 



Le service sort() permet de comparer les éléments d'une liste selon l'ordre donné par une expression 

donnée en paramètre et de renvoyer cette liste triée. 

Si le receveur n'est pas une liste, il renvoie l'objet courant. 

Obsolète : utiliser nsort(String). 


Soit maListe la liste d'objets {d, a, c, f, b, e} 

 

Voir aussi 

nSort(String)

3.2.28 - toString 

toString() 

Renvoie une chaîne de caractères correspondant au receveur. 

Receveur 

Retour 




Page 45/112 


EObject) 

L'objet sous forme de chaîne de caractères. 


Le service “ toString ” transforme l'objet en une chaîne de caractères. Ce service est semblable à celui du 

langage Java. 

Si le receveur est un entier, un double ou un booléen, ce service renvoie la valeur de l'entier, du double ou 

du booléen. Si le receveur est une chaîne de caractères, il renvoie cette chaîne. Si le receveur est une liste 

ou un objet EMF, il renvoie le résultat de la méthode “ toString ” implémentée par EMF, c'est à dire une 

description des attributs de cet objet. Enfin, si le receveur est vide, il renvoie un objet vide. 


Soit a, b et c des objet EMF et maListe la liste d'objets {a, b, c} au sens EMF (EList) : 

: renvoie le nombre d'enfants du receveur sous forme de chaîne de caractères 

: renvoie une description de a : “ package_de_a.type_de_a (attribut1 : valeur1, attribut2 : valeur2, ...) ” 

: renvoie une description de chacun des attributs de liste : “ package_de_a.type_de_a 

(attribut1a : valeur1a, attribut2a : valeur2a, ...) package_de_b.type_de_b (attribut1b : valeur1b, attribut2b : valeur2b, ...) 

package_de_c.type_de_c (attribut1c : valeur1c, attribut2c : valeur2c, ...) ”

3.2.29 - trace 

trace() 


Receveur 

Retour 




Page 46/112 


EObject) 



Le service “ trace ” affiche le type et la valeur du noeud courant. Il fait appel au service “ trace(String) ” en 

passant une chaîne de caractères vide en paramètre. 


Soit a une classe : 

écrit dans la console [numéroDeLaTrace] type = classe value = “ a ” 

Voir aussi 

trace(String), debug()

3.2.30 - trace 

trace(String) 


Receveur 

Paramètre 

Retour 




Page 47/112 


EObject) 

String template : Un template à évaluer pour chaque objet 



Le service “ trace ” affiche le type et la valeur du noeud courant évalué par le template passé en paramètre. 


Pour afficher dans la console tous les noms des attributs d'une classe : 

 

 

Voir aussi 

trace(), debug() 

3.2.31 - until 

until(String,String) : obsolète 

Renvoie l'objet pointé par le lien link du receveur, le type de l'objet étant donné en paramètre. 

Receveur 

Paramètres 

Retour 




Page 48/112 


EObject) 

String link : le lien où doit être recherché un objet de type type 

String type : le type de l'objet recherché 

L'objet recherché 


Le service “ until ” recherche récursivement sur le lien link un objet de type type. La récursivité s'arrête 

quand un objet du type donné est trouvé. Si le receveur est du type donné, le service renvoie le receveur. 

Le receveur doit être un objet EMF (“ EObject ”). Si le receveur n'est pas un objet EMF, il renvoie un objet 

vide. 

Obsolète : ce service n'est pas remplacé, les services EMF implémentent déjà cette opération. 


– a est une instance de la classe A 

– b est une instance de la classe B 

– c est une instance de la classe C 

– “ container ” est un lien du type classe 

– c.container renvoie b 

– b.container renvoie a 

– a.container renvoie null 

: génère le nom de l'instance a. 



: génère une chaîne de caractères vide.


Page 49/112

3.3 - EObjectServices 


Page 50/112 

Cette classe regroupe les services EObjectServices. Ces services sont le lien vers les méthodes EMF du 

même nom, ils font appel à celles-ci. Pour de plus amples informations sur ces méthodes, voir la javadoc 

de EMF présente sur http://download.eclipse.org/tools/emf/2.1.2/javadoc/ (cf. classe “ EObject ”). 



3.3.1 - eAllContents 

eAllContents() 

Renvoie la descendance du receveur. 

Receveur 

Retour 



EObject, c'est à dire tous les types d'objet décrit par EMF 

La liste de la descendance 



Page 51/112 

Le service “ eAllContents ” renvoie tous les objets directement et indirectement contenus dans le receveur. 

Il renvoie les fils, petits-fils, arrière-petits-fils, etc... du receveur. Il ne fait aucune distinction de type, chaque 

objet contenu est renvoyé dans la liste de retour. 

Le receveur peut-être implicite (lors d'une utilisation dans un script ou une boucle). 

Si le receveur est vide, il renvoie une liste vide. 


– a, b, c, d et e sont des objets. 

– a contient b et c, b contient d et d contient e. 

: renvoie {b, c, d, e} 

: renvoie {d, e} 

: renvoie une liste vide. 

Voir aussi 

eAllContents(String)

3.3.2 - eAllContents 

eAllContents(String) 

Renvoie la descendance du receveur dont le type est donné. 

Receveur 

Paramètre 

Retour 




String type : le type des objets recherchés 

La liste des objets contenus de type type. 



Page 52/112 

Le service “ eAllContents ” renvoie tous les objets directement et indirectement contenus dans le receveur, 

s'ils sont du type donné. Il renvoie l'ensemble des fils, petits-fils, arrière-petits-fils, etc... qui ont le type 

demandé. 

Si le receveur est vide, il renvoie une liste vide. 


– p est un package 

– a est une classe de type “ Class ”, elle a pour attribut b de type “ int ”, c de type “ int ” et d de type “ boolean ” 

– e est une classe de type “ Class ”, elle a pour attribut f de type “ int ”, g de type “ String ” et h de type “ Object ” 

: renvoie {b, c, f} 

: renvoie {a, e} 

: renvoie {g} 

: renvoie {b, c} 

: renvoie une liste vide 


Voir aussi 

eAllContents()

3.3.3 - eClass 

eClass() 

Renvoie la classe du receveur 

Receveur 

Retour 




La classe du receveur 



Page 53/112 

Le service “ eClass ” renvoie la classe du métamodèle qui correspond au type du receveur. Son résultat 

correspond à l'attribut “ class ” dans le langage Java. 

Ce service peut permettre de tester le type d'un objet. 


La suite d'instructions contenues entre les balises et est exécutée 

seulement si a est une classe.

3.3.4 - eContainer 

eContainer() 

Renvoie l'objet parent du receveur. 

Receveur 

Retour 




Le parent du receveur 


Le service “ eContainer ” renvoie l'objet qui contient le receveur quel que soit le type de celui-ci. 

Si le receveur n'a pas de parent ou si le receveur est vide, il renvoie un objet vide. 


a est une classe qui contient un attribut b 

: renvoie a 

: renvoie un objet vide 

Voir aussi 

eContainer(String), eContainingFeature(), eContainmentFeature(), eResource() 


Page 54/112

3.3.5 - eContainer 

eContainer(String) 

Renvoie l'objet parent du type donné. 

Receveur 

Paramètre 

Retour 




String type : le type de l'objet recherché 

L'objet parent du type donné 



Page 55/112 

Le service “ eContainer ” recherche récursivement l'ancêtre le plus proche du type donné. La recherche 

s'arrête lorsque un objet du type demandé est trouvé. Si le receveur est du type demandé, le service 

renvoie le receveur. 

Si le receveur n'a pas de parent, si le receveur est vide ou si aucun ancêtre n'est du type demandé, il 

renvoie un objet vide. 


– p est un package de type “ Package ” 

– p contient a, une classe de type “ Class ” 

– a contient b, un attribut de type “ String ” 

: renvoie p 

: renvoie p 



Voir aussi 

eContainer(), eContainingFeature(), eContainmentFeature(), eResource()

3.3.6 - eContainingFeature 

eContainingFeature() 

Renvoie le lien qui relie le receveur avec son objet parent. 

Receveur 

Retour 




Le lien avec l'objet parent 


Le service “ eContainingFeature ” renvoie le lien avec l'objet parent instancié par le receveur. 

Si le receveur est vide ou qu'il n'a pas de parent, il renvoie un lien vide. 


 


Page 56/112

3.3.7 - eContainmentFeature 

eContainmentFeature() 

Renvoie le lien qui relie le receveur avec son objet parent. 

Receveur 

Retour 




Le lien avec l'objet parent 


Le service “ eContainmentFeature ” renvoie le lien avec l'objet parent instancié par le receveur. 

Si le receveur est vide ou qu'il n'a pas de parent, il renvoie un lien vide. 


 


Page 57/112

3.3.8 - eContents 

eContents() 

Renvoie les objets directement contenus dans le receveur. 

Receveur 

Retour 




La liste des fils du receveur 



Page 58/112 

Le service “ eContents ” renvoie la liste de tous les objets enfants directs du receveur. Cette liste ne 

contient pas les petits-fils du receveur. Ce service ne fait pas de distinction liée aux types des fils du 

receveur. 

Si le receveur est vide ou ne contient aucun objet, il renvoie une liste vide. 


– p est un package qui contient a, une classe 

– a contient b et c, des attributs 

: renvoie {b, c} 

: renvoie {a} 


Voir aussi 

eAllContents(), eAllContents(String)

3.3.9 - eCrossReferences 

eCrossReferences() 

Renvoie la liste des références du receveur. 

Receveur 

Retour 




La liste des références 



Page 59/112 

Le service “ eCrossReferences ” renvoie la liste des objets référencés par un lien dans le receveur. Les 

objets référencés par des liens de contenance ne sont pas pris en compte. La liste de ces objets est 

déterminée à partir des liens du receveur. 

Si le receveur est vide ou qu'il n'a aucun lien autre que des liens de contenance, une liste vide est 

renvoyée. 


– a est une classe qui hérite d'une classe b et qui implémente une interface c, elle a les attribut d et e. 

: renvoie {b, c}. d et e ne sont pas renvoyé car le lien avec la classe a est un lien de 

contenance et non un lien de référence.

3.3.10 - eResource 

eResource() 

Renvoie le chemin du fichier contenant le modèle 

Receveur 

Retour 




Le chemin du fichier 



Page 60/112 

Le service “ eResource ” renvoie l'adresse du fichier où est contenu le receveur. Pour y accéder, ce service 

recherche l'élément de haut niveau à partir duquel il pourra récupérer le chemin du fichier qui contient cet 

objet. 


Si on appelle ce service sur la classe “ ArticleDeBlog ”, il renvoie 

“ /resource/fr.obeo.sample.demo.weblog.model/uml2/WebLog_fr.uml2 ”.

3.3.11 - eResourceName 

eResourceName() 

Donne le nom de la ressource (extension comprise). 

Receveur 

Retour 




Le nom de la ressource (extension comprise). 



Page 61/112 

Le service “ eResourceName ” renvoie le nom du fichier qui contient cet objet (extension comprise). Si ce 

nom ne peut pas être trouvé, il renvoie null. 


L'appel de ce service sur un objet contenu dans le fichier “ C:/Obeo/models/MyModel.xmi ” renvoie “ MyModel.xmi ”. 

Voir aussi 

eResource()

3.3.12 - getRootContainer 

getRootContainer() 

Renvoie l'objet de haut niveau du modèle qui contient l'élément courant. 

Receveur 

Retour 




L'élément de haut-niveau 



Page 62/112 

Le service “ getRootContainer ” renvoie l'élément racine du modèle courant. Cet objet n'a pas de parent : il 

est directement contenu dans la ressource. 


Si un modèle contient un objet a qui contient un objet b qui lui-même contient un objet c : 

renvoie a. 

Voir aussi 

eContainer(), eContainer(String)

3.3.13 - load 

load(String) 

Charge un modèle et renvoie l'objet de haut niveau. 

Receveur 

Paramètre 

Retour 




String path : le chemin du modèle à charger 

L'objet de haut-niveau 



Page 63/112 

Le service “ load ” charge un modèle à partir du chemin passé en paramètre. Si le chargement s'effectue 

correctement, le service renvoie l'élément de haut niveau du modèle. Si le chemin est incorrect ou si le 

modèle ne peut pas se charger correctement, une exception est levée. 


L'exécution de l'instruction permet de récupérer 

l'élément de haut-niveau qui contient tous les types primitifs en UML2.

3.4 - PropertiesServices 


Page 64/112 

Cette classe regroupe les services PropertiesServices. Les propriétés sont stockées sous la forme clé = 

valeur dans un fichier d'extension “ .properties ”. Ces propriétés permettent de paramétrer les scripts. 

Ces services recherchent, en premier lieu, la clé dans les fichiers de propriétés présents dans le même 

répertoire que la chaîne de génération (fichier d'extension “ .chain ”) ou, dans un deuxième temps, dans le 

même répertoire que le template de génération (fichier d'extension “ .mt ”). S'ils ne trouvent pas de fichier de 

propriétés dans ces répertoires ou s'ils ne contiennent pas la clé demandée, ils génèrent une exception 

“ Empty feature evaluation ”. Si la clé existe plusieurs fois dans ces fichiers, ils prennent la valeur de la 

première occurrence trouvée. 

Il est à noter que lors d'une pré-visualisation dans l'éditeur réflectif (éditeur d'Acceleo), les fichiers de 

propriétés doivent obligatoirement être présent dans le même répertoire que le fichier de génération (“ .mt ”). 


Disponibilité : Acceleo v1.0 

Schéma de fonctionnement général : 

Le fichier de 

propriétés est dans le 

même répertoire que 

la chaîne de 

génération 

Une propriété : de sa définition à sa génération

3.4.1 - getBestProperty 

getBestProperty(String) 

Pré-requis : comprendre la méthode getProperty(String) 

Renvoie la valeur de la propriété dont la clé est la plus proche de celle donnée en paramètre. 

Receveur 

Paramètre 

Retour 




Page 65/112 


EObject) 

String key : l'identifiant de la propriété. 

La valeur de la propriété la plus proche. 


Le service “ getBestProperty ” renvoie la valeur identifiée par la clé donnée en paramètre. Cette valeur est 

stockée dans un fichier de propriétés (“ .properties”). Si la clé n'est trouvé dans aucun des fichiers de 

propriétés, il recommence la recherche avec une clé minimale jusqu'à trouver une clé assez proche. 

Si aucune valeur n'est trouvée, il renvoie un objet vide. 

Ce service recherche en premier lieu, la clé dans les fichiers de propriétés présents dans le même 


même répertoire que le template de génération (fichier d'extension “ .mt ”). S'il ne trouve pas de fichier de 

propriétés dans ces répertoires ou s'ils ne contiennent pas la clé demandée, il génère une exception 

“ Empty feature evaluation ”. S'il existe plusieurs fois la clé dans ces fichiers, il prend la valeur de la 



Pour une clé “ aa.bb.cc.dd ”, le service renvoie le résultat de getProperty(“ aa.bb.cc.dd ”) ou, s'il ne trouve pas cette clé, 

getProperty(“ aa.bb.cc ”) ou, s'il ne trouve pas cette clé, getProperty(“ aa.bb ”), ou ... 

Ce service peut être utilisé pour donner une valeur par défaut à une série de propriétés préfixées. Si toutes les 

propriétés commencent par “ fr.obeo ”, toutes les propriétés préfixées de cette manière auront au minimum cette valeur 

à moins que la propriété soit précisée. 

Voir aussi 

getProperty()

3.4.2 - getProperty 

getProperty(String) 

Renvoie la propriété référencée par la clé key. 

Receveur 

Paramètre 

Retour 




Page 66/112 


EObject) 

String key : la clé qui identifie la propriété 

La valeur de la propriété identifiée par key 


Le service “ getProperty ” recherche la clé key dans un fichier de propriétés. S'il la trouve, il renvoie la 

valeur associée à cette clé sinon il renvoie un objet vide. 








cf. exemple p. 35 

Permet à l'utilisateur de personnaliser sa génération. Par exemple, les noms de package peuvent être écrits dans un 

fichier de propriétés. Chacun des scripts de génération viendra chercher la valeur correspondante pour compléter les 

espaces où il a besoin du nom de package. 

Voir aussi 

getProperty(String, String)

3.4.3 - getProperty 

getProperty(String,String) 


Page 67/112 

Renvoie la propriété référencée par la clé key dans le fichier de propriété name (sans extension). 

Receveur 

Paramètres 

Retour 




EObject) 

String name : le nom du fichier de propriétés (sans extension) 

String key : la clé de la propriété 

La valeur de la propriété 


Le service “ getProperty ” recherche la clé key dans le fichier de propriétés name. S'il la trouve, il renvoie la 

valeur associée à cette clé sinon il renvoie un objet vide. 








cf. exemple p. 35 : aux instructions entourées du fichier “ entity.mt ”, on peut ajouter un premier paramètre “ weblog ”. 

Dans ce cas, le fichier de propriétés est obligatoirement “ weblog.properties ”. 

Permet à l'utilisateur de personnaliser sa génération. Par exemple, les noms de package peuvent être écrits dans un 

fichier de propriétés. Chacun des scripts de génération viendra chercher la valeur correspondante pour compléter les 

espaces où il a besoin du nom de package. 

Voir aussi 

getProperty()

3.5 - RequestServices 


Page 68/112 

Cette classe regroupe les services RequestServices. Ces services s'appliquent sur tous les types d'objets. 

Ils permettent de faire des requêtes sur cet objet. 



3.5.1 - delete 

delete(String) : obsolète 

Supprime de la liste les éléments qui valident la condition passée en paramètre. 

Receveur 

Paramètre 

Retour 




Page 69/112 


EObject) 

String call : expression de condition à évaluer sur chacun des éléments 

La liste sans les éléments qui ont vérifié l'expression call 


Le service “ delete ” évalue pour chacun des éléments de la liste si la condition de l'expression call est 

vérifiée. Si oui, on supprime cet élément sinon on passe à l'élément suivant. Une fois tous les éléments 

passés en revue, on renvoie la liste. 

Ce service est l'inverse du service “ select ” dans le sens ou les éléments sont supprimés si la condition est 

satisfaite. 

Si le service est appelé sur un objet autre qu'une liste, il renvoie l'objet s'il ne satisfait pas la condition de 

l'expression call sinon il renvoie un objet vide. Si le service est appelé sur un objet vide, il renvoie un objet 

vide. 

Obsolète : utiliser les expressions avec les “ [] ”. Pour plus d'information, regarder la section " Requêtage " 

du Guide utilisateur. 

Acceleo propose donc une syntaxe à base de crochets '[...]', qui se rapproche de la syntaxe Xpath, pour ne 

conserver dans les éléments à gauche de la requête que les éléments qui répondent au critère exprimé à 

l'intérieur des crochets. A l'intérieur des crochets, l'objet courant est celui que l'on cherche à filtrer. Voici des 

équivalents de l'exemple d'utilisation. 

 


 

Le service “ eAllContents ” permet de récupérer la liste de toutes les classes contenues dans le receveur. Sur cette liste, 

on enlève toutes celles qui n'ont aucun attribut (dont la taille de la liste des attributs est égal à 0). 

Voir aussi 

Section " Requêtage " du Guide utilisateur, select()

3.5.2 - delete 

delete(String,String) : obsolète 


Page 70/112 

Supprime de la liste les éléments dont l'expression passée en paramètre est égale à la valeur passée en 

paramètre. 

Receveur 

Paramètres 

Retour 




EObject) 

String call : expression à évaluer sur chacun des éléments 

String value : valeur qui valide l'expression call 

La liste sans les éléments qui ont vérifié call = value 


Le service “ delete ” évalue pour chacun des éléments de la liste si l'expression call est égale à la valeur value. Si oui, 

on supprime cet élément sinon on passe à l'élément suivant. Une fois tous les éléments passés en revue, on renvoie la 

liste. 

Ce service est l'inverse du service “ select ” dans le sens ou les éléments sont supprimés si la condition est satisfaite. 

Si le service est appelé sur un objet autre qu'une liste, il renvoie l'objet s'il ne satisfait pas la condition de l'expression 

call sinon il renvoie un objet vide. Si le service est appelé sur un objet vide, il renvoie un objet vide. 

Obsolète : utiliser les expressions avec les “ [] ”. Pour plus d'information, regarder la section " Requêtage " du Guide 

utilisateur. 

Acceleo propose donc une syntaxe à base de crochets '[...]', qui se rapproche de la syntaxe Xpath, pour ne conserver 

dans les éléments à gauche de la requête que les éléments qui répondent au critère exprimé à l'intérieur des crochets. A 

l'intérieur des crochets, l'objet courant est celui que l'on cherche à filtrer. Voici des équivalents de l'exemple d'utilisation. 

 


 


on enlève toutes celles qui n'ont aucun attribut (dont la taille de la liste des attributs est égal à 0). On récupère donc la 

liste des classes qui ont au moins un attribut. 

Voir aussi 

Section " Requêtage " du Guide utilisateur, select()

3.5.3 - evaluate 

evaluate(String) 

Renvoie l'objet de l'évaluation de l'expression passée en paramètre. 

Receveur 

Paramètre 

Retour 




Page 71/112 


EObject) 

String call : l'expression à évaluer 

Le résultat de l'évaluation de l'expression. 


Le service “evaluate” exécute l'expression comme une expression d'Acceleo sur le receveur. Il renvoie 

l'objet qui résulte de l'évaluation de cette expression. Si l'expression ne renvoie rien, il renvoie un objet 

vide. 



 

Le service “ eAllContents ” renvoie la liste de toutes les classes contenues dans le receveur. Sur chaque élément de 

cette liste, on vient chercher le nombre d'attributs qu'elle contient (“ attributes.nSize() ”). Enfin, entre chacun de ces 

nombres, on vient concaténer un signe +. Le service “ evaluate ” permet de résoudre cette somme. On récupère ainsi le 

nombre d'attributs indirectement contenus dans le receveur. 

Sans le service “ evaluate ”, l'instruction aurait 

renvoyé une chaîne de caractères correspondant à la description de la somme et non pas son résultat.

3.5.4 - select 

select(String) : obsolète 

Garde dans la liste seulement les éléments qui valident la condition passée en paramètre. 

Receveur 

Paramètre 

Retour 




Page 72/112 


EObject) 

String call : l'expression de la condition à vérifier 

La liste contenant seulement les éléments qui ont vérifié l'expression 


Le service “ select ” évalue pour chacun des éléments de la liste si la condition de l'expression call est 

vérifiée. Si non, on supprime cet élément et on passe à l'élément suivant. Une fois tous les éléments 

passés en revue, on renvoie la liste. 

Ce service est l'inverse du service “ delete ”dans le sens ou les éléments sont supprimés si la condition 

n'est pas satisfaite. 

Si le service est appelé sur un objet autre qu'une liste, il renvoie l'objet s'il ne satisfait pas la condition de 

l'expression call sinon il renvoie un objet vide. Si le service est appelé sur un objet vide, il renvoie un objet 

vide. 

Obsolète : utiliser les expressions avec les “ [] ”. Pour plus d'information, regarder la section " Requêtage " 

du Guide utilisateur. 

Acceleo propose donc une syntaxe à base de crochets '[...]', qui se rapproche de la syntaxe Xpath, pour ne 

conserver dans les éléments à gauche de la requête que les éléments qui répondent au critère exprimé à 

l'intérieur des crochets. A l'intérieur des crochets, l'objet courant est celui que l'on cherche à filtrer. Voici 

l'équivalent de l'exemple d'utilisation. 

 


 


on ne garde seulement que celles qui n'ont aucun attribut (dont la taille de la liste des attributs est égal à 0). 

Voir aussi 

Section " Requêtage " du Guide utilisateur, delete()

3.5.5 - select 

select(String,String) : obsolète 


Page 73/112 

Garde dans la liste seulement les éléments dont l'expression passée en paramètre est égale à la valeur 

passée en paramètre. 

Receveur 

Paramètres 

Retour 




EObject) 

String call : l'expression à évaluer sur chacun des éléments 

String value : valeur qui valide l'expression call 

La liste contenant seulement les éléments qui ont vérifié l'expression 


Le service “ select ” évalue pour chacun des éléments de la liste si l'expression call est égale à la valeur value. Si non, 

on supprime cet élément et on passe à l'élément suivant. Une fois tous les éléments passés en revue, on renvoie la 

liste. 

Ce service est l'inverse du service “ delete ” dans le sens ou les éléments sont supprimés si la condition n'est pas 

satisfaite. 

Si le service est appelé sur un objet autre qu'une liste, il renvoie l'objet s'il ne satisfait pas la condition de l'expression 

call sinon il renvoie un objet vide. Si le service est appelé sur un objet vide, il renvoie un objet vide. 

Obsolète : utiliser les expressions avec les “ [] ”. Pour plus d'information, regarder la section " Requêtage " du Guide 

utilisateur. 

Acceleo propose donc une syntaxe à base de crochets '[...]', qui se rapproche de la syntaxe Xpath, pour ne conserver 

dans les éléments à gauche de la requête que les éléments qui répondent au critère exprimé à l'intérieur des crochets. A 

l'intérieur des crochets, l'objet courant est celui que l'on cherche à filtrer. Voici l'équivalent de l'exemple d'utilisation. 

 


 


on ne garde seulement que celles qui n'ont aucun attribut (dont la taille de la liste des attributs est égal à 0). 

Voir aussi 

Section " Requêtage " du Guide utilisateur, delete()

3.6 - ResourceServices 


Page 74/112 

Cette classe regroupe les services ResourceServices. Ces services permettent d'effectuer des actions sur 

les ressources eclipse. 



3.6.1 - getFileContent 

getFileContent(String) 

Renvoie le contenu d'un fichier. 

Receveur 

Paramètre 

Retour 




Page 75/112 


EObject) 

String path : Le chemin du fichier dont on cherche le contenu. 

Le contenu du fichier 


Le service “ getContentFile ” permet de récupérer le contenu d'un fichier dont le chemin d'accès est passé 

en paramètre. Si le fichier est vide ou s'il n'est pas trouvé, il renvoie un tampon vide. 

Le contenu du fichier est renvoyé sous forme textuelle. 


renvoie le contenu sous forme XML (chaîne de caractères) du 

modèle MyModel, ce qui permet, par exemple de récupérer le numéro de version du XMI utilisé.

3.6.2 - getChainPath 

getChainPath() 

Renvoie le chemin de la chaîne de haut niveau qui a lancé la génération en cours. 

Receveur 

Retour 




Page 76/112 


EObject) 

Le chemin de la chaîne qui a lancé la génération 

Acceleo V2.5.1 

Le service “getChainPath” permet de récupérer le chemin de la chaîne de haut niveau qui a lancé la 

génération. 


renvoie le chemin de la chaîne de haut niveau qui a lancé la génération.

3.7 - SpecialsServices 


Page 77/112 

Cette classe regroupe les services SpecialsServices. Ces services sont spécifiques à la syntaxe Acceleo. 

Ils permettent de récupérer des informations propres au déroulement d'une génération. 



i() 

3.7.1 - i 

Renvoie l'indice de l'itération courante. 

Receveur 

Retour 




Page 78/112 


EObject) 

L'objet de l'itération courante 


Le service “ i ” renvoie l'indice courant, dans une boucle “ for ”. 

La première itération renvoie 0. 


public void method(, ) {... 

Cette ligne d'instruction permet de générer la signature de la méthode “ method ”. On ne génère pas de virgule avant le 

premier paramètre, si on est dans la première itération de la boucle “ for ”.

3.7.2 - args 

args(int) 

Renvoie l'argument passé en paramètre du script à la position donnée. 

Receveur 

Paramètre 

Retour 




Page 79/112 


EObject) 

int pos : position du paramètre recherché. 

Le paramètre recherché 


Le service “ args ” renvoie le paramètre du script situé à la position donnée. 

Le premier argument a pour indice 0. 


Pour faire appel à un script “ monScript ” avec les paramètres “ test ” et “ autreTest ”, on peut écrire l'instruction 

suivante : 

 

Le script “ monScript ” récupère ces paramètres grâce à ces instructions : 

 

Voici le premier argument (“ test ”) : 

Voici le deuxième argument (“ autreTest ”) :

3.8 - StringServices 


Page 80/112 

Cette classe regroupe les services StringServices. Ces services sont un lien vers les méthodes Java du 

même nom. Pour de plus amples informations sur ces méthodes, voir la javadoc de Java présente sur 

http://java.sun.com/j2se/1.5.0/docs/api/. 



3.8.1 - charAt 

charAt(int) 

Renvoie le caractère à la position donnée en paramètre. 

Receveur 

Paramètre 

Retour 


String 


int index : position du caractère recherché. 

Le caractère recherché 



Page 81/112 

Le service “ charAt ” renvoie le caractère à la position donnée. Il utilise la méthode charAt() du langage 

Java. L'indice du premier caractère est 0. 


 

Le service “ eContainer ” renvoie le parent de l'objet courant. On vient ensuite vérifier si le nom de ce parent à la 

caractère “ a ” en première position.

3.8.2 - endsWith 

endsWith(String) 

Indique si le receveur se termine par la chaîne donnée en paramètre. 

Receveur 

Paramètre 

Retour 


String 


String arg : le suffixe recherché 

Vrai si le suffixe du receveur est arg sinon faux. 



Page 82/112 

Le service “ endsWith ” indique si le suffixe du receveur est celui donné en paramètre. Il utilise la méthode 

endsWith du langage Java. Si la chaîne passée en paramètre est vide, alors le résultat renvoyé est vrai, 

sinon il utilise la méthode “ equals ” du langage Java. 


 

Le service “ eResource ” renvoie une chaîne de caractère correspondant au chemin du fichier courant. Si cette chaîne 

se termine par “ .xmi ” alors la condition est vérifiée. 

Voir aussi 

startsWith(), indexOf()

3.8.3 - equalsIgnoreCase 

equalsIgnoreCase(String) 

Indique si deux chaînes de caractères sont égales ou non en ignorant la casse. 

Receveur 

Paramètre 

Retour 


String 


String arg : une chaîne de caractères pour comparer 

Vrai si les chaînes sont égales, sinon faux 



Page 83/112 

Le service “ equalsIgnoreCase ” indique l'égalité entre la chaîne de caractères du receveur et celle passée 

en paramètre sans prendre la casse en considération. Il utilise la méthode “ equalsIgnoreCase ” du langage 

Java. Chaque caractère est comparé un à un. Ces caractères sont considérés égaux si une de ces trois 

conditions est vérifiée : l'opérateur “ == ” sur ces caractères renvoie vrai, ou la mise en majuscule de 

chacun de ces caractères renvoie le même résultat ou la mise en minuscule de chacun de ces caractères 

renvoie le même résultat. 


 

Le service “ eContainer ” renvoie le parent de l'objet courant. Si le nom de celui est “ maClass ” ou “ MACLASS ” ou 

“ maclass ” ou “ MaClAsS ” etc..., alors la condition est vérifiée.

3.8.4 - indentSpace 

indentSpace() 

Renvoie la chaîne de caractères indentée par un espace. 

Receveur 

Retour 




Page 84/112 


EObject) 

La chaîne de caractères indentée par un espace 


Le service “ indentSpace ” renvoie la chaîne de caractère réceptrice indentée par un espace. 


génère “ abcdefg ”. 

Voir aussi 

indentTab()

3.8.5 - indentTab 

indentTab() 

Renvoie la chaîne de caractères indentée par une tabulation. 

Receveur 

Retour 




Page 85/112 


EObject) 

La chaîne de caractères indentée par une tabulation 


Le service “ indentTab ” renvoie la chaîne de caractère réceptrice indentée par une tabulation. 


génère “ abcdefg ”. 

Voir aussi 

indentSpace()

3.8.6 - indexOf 

indexOf(String) 

Renvoie la première position d'une chaîne de caractères à l'intérieur du receveur. 

Receveur 

Paramètre 

Retour 


String 


String arg : la chaîne de caractères recherchée 


Page 86/112 

L'indice de la première occurrence de la chaîne arg ou -1 si arg n'a pas été trouvée. 


Le service “ indexOf ” renvoie l'indice du premier caractère de la première occurrence de la chaîne arg 

trouvée dans le receveur. Ce service utilise la méthode “ indexOf ” du langage Java. Il renvoie la plus petite 

valeur de k tel que “ receveur.startsWith(arg, k) ” est vrai. 

Si la chaîne arg n'est pas trouvée dans le receveur, il renvoie -1. 


: permet de retrouver l'indice de fin du disque de “ monCheminDAcces ” 

Voir aussi 

indexOf(String, int), lastIndexOf(String), startsWith(), endsWith()

3.8.7 - indexOf 

indexOf(String,int) 


Page 87/112 

Renvoie la première position d'une chaîne de caractères à l'intérieur du receveur à partir d'un certain indice 

donné en paramètre. 

Receveur 

Paramètres 

Retour 


String 



int index : l'indice à partir duquel on commence la recherche 

L'indice de la première occurrence de la chaîne arg dans le receveur, ou -1 si arg n'a 

pas été trouvée 


Le service “ indexOf ” renvoie l'indice du premier caractère de la première occurrence de la chaîne arg 

trouvée dans le receveur à partir du rang index. Ce service utilise la méthode “ indexOf ” du langage Java. 

Il renvoie la plus petite valeur de k tel que “ k >= index ” et “ receveur.startsWith(arg, k) ” est vrai. 

Si la chaîne arg n'est pas trouvée dans le receveur, il renvoie -1. Si index est supérieur à la longueur du 

receveur, il renvoie -1. 


: permet de retrouver l'indice de fin du premier 

dossier de monCheminDAcces. 

Voir aussi 

indexOf(String), lastIndexOf(String, int), startsWith(), endsWith()

3.8.8 - lastIndexOf 

lastIndexOf(String) 

Renvoie la dernière position d'une chaîne de caractères à l'intérieur du receveur. 

Receveur 

Paramètre 

Retour 


String 




Page 88/112 

L'indice de la dernière occurrence de la chaîne arg ou -1 si arg n'a pas été trouvée. 


Le service “ lastIndexOf ” renvoie l'indice du premier caractère de la dernière occurrence de la chaîne arg 

trouvée dans le receveur. Ce service utilise la méthode “ lastIndexOf ” du langage Java. Il renvoie la plus 

grande valeur de k tel que “ receveur.startsWith(arg, k) ” est vrai. 

Si la chaîne arg n'est pas trouvée dans le receveur, il renvoie -1. 


: permet de retrouver l'indice du premier caractère du nom du fichier de 

monCheminDAcces. 

Voir aussi 

lastIndexOf(String, int), indexOf(String), startsWith(), endsWith()

3.8.9 - lastIndexOf 

lastIndexOf(String,int) 


Page 89/112 

Renvoie la dernière position d'une chaîne de caractères à l'intérieur du receveur avant un certain indice 

donné en paramètre. 

Receveur 

Paramètres 

Retour 


String 



int index : l'indice avant lequel on fait la recherche 

L'indice de la dernière occurrence de la chaîne arg dans le receveur, ou -1 si arg n'a 

pas été trouvée. 


Le service “ lastIndexOf ” renvoie l'indice du premier caractère de la dernière occurrence de la chaîne arg 

trouvée dans le receveur à partir du rang index. Ce service utilise la méthode “ lastIndexOf ” du langage 

Java. Il renvoie la plus grande valeur de k tel que “ k

3.8.10 - length 

length() 

Renvoie la longueur de la chaîne de caractères. 

Receveur 

Retour 


String 


La longueur de la chaîne de caractères 



Page 90/112 

Le service “ length ” renvoie la longueur de la chaîne de caractères. Il utilise la méthode “ length ” du 

langage Java. 


: retourne la longueur de l'attribut “ name ” de l'objet.

3.8.11 - matches 

matches(String) 

Indique si le receveur correspond à l'expression régulière passée en paramètre. 

Receveur 

Paramètre 

Retour 


String 


String regex : l'expression régulière 

Vrai si le receveur correspond à l'expression régulière regex, sinon faux 



Page 91/112 

Le service “ matches ” indique si le receveur est de la forme de l'expression régulière. Il utilise la méthode 

“ matches ” du langage Java. Voici les expressions régulières de caractères : 

• [abc] a, b, ou c (simple classe) 

• [^abc] Tous les caractères sauf a, b, ou c (négation) 

• [a-zA-Z] de a jusqu'à z ou de A jusqu'à Z, inclusif 

• [a-d[m-p]] de a jusqu'à d, ou de m jusqu'à p: [a-dm-p] (union) 

• [a-z&&[def]] d, e, ou f (intersection) 

• [a-z&&[^bc]] de a jusqu'à z, sauf b et c: [ad-z] (soustraction) 

• [a-z&&[^m-p]] de a jusqu'à z, sauf de m jusqu'à p: [a-lq-z](soustraction) 

Référez vous à la javadoc du langage Java pour connaître les expressions régulières sur les autres types 

de donnée. 


: renvoie toutes les opérations qui commencent par “ get ”

3.8.12 - replaceAll 

replaceAll(String,String) 


Page 92/112 

Remplaces toutes les occurrences de la première chaîne de caractères par la deuxième chaîne de 

caractères. 

Receveur 

Paramètres 

Retour 


String 


String s1 : la chaîne à remplacer 

String s2 : la chaîne qui remplace s1 

La nouvelle chaîne de caractères 


Le service “ replaceAll ” recherche chaque occurrence de la première chaîne de caractères passée en 

paramètre dans le receveur et la remplace par la deuxième chaîne de caractères passée en paramètre. Il 

utilise la méthode “ replaceAll ” du langage Java. 


package : remplace tous les “ / ” par des “ . ” 

Voir aussi 

replaceFirst()

3.8.13 - replaceFirst 

replaceFirst(String,String) 


Page 93/112 

Remplaces la première occurrence de la première chaîne de caractères par la deuxième chaîne de 

caractères. 

Receveur 

Paramètres 

Retour 


String 


String s1 : la chaîne à remplacer 

String s2 : la chaîne qui remplace s1 

La nouvelle chaîne de caractères 


Le service “ replaceFirst ” recherche la première occurrence de la première chaîne de caractères passée 

en paramètre dans le receveur et la remplace par la deuxième chaîne de caractères passée en paramètre. 

Il utilise la méthode “ replaceFirst ” du langage Java. 


: remplace le préfixe “ I ” de “ monInterface ” par “ i”, renvoie 

“ moninterface ” 

Voir aussi 

replaceAll()

3.8.14 - split 

split(String) 

Découpe le receveur en plusieurs chaînes de caractères selon celle donnée en paramètre. 

Receveur 

Paramètre 

Retour 


String 


String regex : L'expression régulière qui délimite 

La liste de tous les découpages 



Page 94/112 

Le service “ split ” découpe le receveur en deux chaînes de caractères distinctes à chaque fois qu'il 

rencontre la chaîne arg. Il utilise la méthode “ split ” du langage Java. 


Sur une chaîne “ boo:and:foo ”, 

– avec “ : ” passé en paramètre, le résultat est {“ boo ”, “ and ”, “ foo ”} 

– avec “ o ” passé en paramètre, le résultat est {“ b ”, “”, “ :and:f ”}

3.8.15 - startsWith 

startsWith(String) 

Indique si le receveur commence par la chaîne donnée en paramètre. 

Receveur 

Paramètre 

Retour 


String 


String arg : le préfixe recherché 

Vrai si le préfixe du receveur est arg sinon faux. 



Page 95/112 

Le service “ startsWith ” indique si le préfixe du receveur est celui donné en paramètre. Il utilise la méthode 

“ startsWith ” du langage Java. Si la chaîne passée en paramètre est vide, alors le résultat renvoyé est vrai, 

sinon il utilise la méthode “ equals ” du langage Java. 


 

... : suite d'instructions exécutées seulement pour les objets dont le nom commence par “ i ” comme “ interface ” 

 

Voir aussi 

endsWith(), indexOf()

3.8.16 - substring 

substring(int) 


Page 96/112 

Renvoie une chaîne de caractères qui commence à l'indice spécifié et se termine à la fin de la chaîne. 

Receveur 

Paramètre 

Retour 




EObject) 

int begin : l'indice de début, inclus 

Le morceau de chaîne de caractères 


Le service “ substring ” retourne la fin du receveur à partir de l'indice passé en paramètre. Il utilise la 

méthode “ substring ” du langage Java. Le caractère à l'indice begin est inclus dans le résultat. 

Si l'indice passé en paramètre est négatif ou supérieur à la longueur du receveur, une chaîne vide est 

renvoyée. 


: renvoie le dernier segment de la chaîne de 

caractères d'un chemin d'accès (par exemple, le nom de fichier). 

Voir aussi 

substring(int, int)

3.8.17 - substring 

substring(int,int) 


Page 97/112 

Renvoie une chaîne de caractères qui commence au premier indice spécifié et se termine au deuxième 

indice spécifié. 

Receveur 

Paramètres 

Retour 




EObject) 

int begin : indice de début, inclus 

int end : indice de fin, exclu 

Le morceau de chaîne de caractères 


Le service “ substring ” retourne la chaîne comprise entre les indices passés en paramètre. Il utilise la 

méthode “ substring ” du langage Java. Le caractère à l'indice begin est inclus dans le résultat. Le 

caractère à l'indice end est exclus du résultat. 

Une chaîne vide est renvoyée : 

– si l'indice begin est négatif 

– si l'indice end est négatif 

– si l'indice begin est supérieur à la longueur du receveur 

– si l'indice end est supérieur à l'indice begin 

Si l'indice end est supérieur à la longueur de la chaîne de caractères, le service fait appel au service 

“ substring ” avec, en paramètre, l'indice begin. 


 

renvoie le nom du fichier sans l'extension 

Voir aussi 

substring(int)

3.8.18 - toL1Case 

toL1Case() 

Permet de mettre le premier caractère d'une chaîne en minuscule. 

Receveur 

Retour 




Page 98/112 


EObject) 

La chaîne de caractères avec le premier caractère en minuscule 


Le service “ toL1Case ” renvoie une chaîne de caractère avec le premier caractère de celle-ci en minuscule. 


génère “ aBCDEFGH ”. 

Voir aussi 

toUpperCase(), toLowerCase()

3.8.19 - toLowerCase 

toLowerCase() 

Renvoie une chaîne de caractère avec tous les caractères en minuscules. 

Receveur 

Retour 




Page 99/112 


EObject) 

La chaîne en minuscules 


Le service “ toLowerCase ” renvoie une chaîne de caractères en changeant la casse de tous les 

caractères. Chacun de ceux-ci est en minuscule. Il fait appel à la méthode “ toLowerCase ” du langage 

Java. 


: renvoie “ monpackage ”. 

Voir aussi 

toUpperCase()

3.8.20 - toU1Case 

toU1Case() 

Permet de mettre le premier caractère d'une chaîne en majuscule. 

Receveur 

Retour 




Page 100/112 


EObject) 

La chaîne de caractères avec le premier caractère en majuscule 


Le service “ toU1Case ” renvoie la chaîne de caractère avec le premier caractère de celle-ci en majuscule. 


génère “ Abcdefgh ”. 

Voir aussi 

toUpperCase(), toLowerCase()

3.8.21 - toUpperCase 

toUpperCase() 

Renvoie une chaîne avec tous les caractères en majuscules. 

Receveur 

Retour 




Page 101/112 


EObject) 

La chaîne en majuscules 


Le service “ toUpperCase ” renvoie le receveur en changeant la casse de tous les caractères. Chacun de 

ceux-ci est en majuscule. Il fait appel à la méthode “ toUpperCase ” du langage Java. 


: renvoie “ MA_CONSTANTE ” 

Voir aussi 

toLowerCase()

3.8.22 - trim 

trim() 

Supprime tous les espaces en début et en fin du receveur. 

Receveur 

Retour 




Page 102/112 


EObject) 

La chaîne sans espace au début et à la fin. 


Le service “ trim ” supprime les espaces présents en début et en fin de la chaîne de caractères. Il utilise la 

méthode “ trim ” du langage Java. 


: génère la chaîne de caractères “ abc ”

3.9 - XpathServices 


Page 103/112 

Cette classe regroupe les services XpathServices. Ces services permettent de naviguer dans le modèle en 

utilisant les termes du langage Xpath. Le schéma ci-dessous regroupe l'ensemble des services proposés 

ainsi que leurs significations. Pour de plus amples informations sur le langage Xpath, voir le site 

http://www.w3.org/TR/xpath. 



3.9.1 - ancestor 

ancestor() 

Renvoie la liste de tous les ancêtres de l'objet. 

Receveur 

Retour 




La liste de tous les ancêtres de l'objet 



Page 104/112 

Le service “ ancestor ” a la même sémantique que la notion d'ancêtre en Xpath : il renvoie l'ensemble des 

ancêtres (parent, grands-parent, arrière-grands-parent, etc...) de l'objet du receveur. 


: renvoie toutes la hiérarchie qui supporte “ maClass ” 

Voir aussi 

parent(), descendant()

3.9.2 - child 

child() 

Renvoie l'ensemble des enfants directs du receveur. 

Receveur 

Retour 




La liste des enfants de l'objet 



Page 105/112 

Le service “ child ” a la même sémantique que la notion d'enfant en Xpath : il renvoie l'ensemble des 

enfants de l'objet du receveur. Seul les enfants directs sont renvoyés. 


: renvoie tous les enfants directs de “ maClass ”, c'est à dire, les attributs, les opérations, etc... 

Voir aussi 

descendant(), parent()

3.9.3 - descendant 

descendant() 

Renvoie l'ensemble de la descendance du receveur. 

Receveur 

Retour 




La liste de toute sa descendance 



Page 106/112 

Le service “ descendant ” a la même sémantique que la notion de descendance en Xpath : il renvoie 

l'ensemble des descendants (enfants, petits-enfants, arrière-petits-enfants, etc...) de l'objet du receveur. 


: renvoie tous les fils et petits-fils de “ monPackage ”, c'est à dire les classes de ce 

package, les attributs et les opérations de ces classes. 

Voir aussi 

child(), eAllContents(), ancestor()

3.9.4 - following 

following() 

Renvoie l'ensemble des objets suivants le receveur. 

Receveur 

Retour 




La liste des objets suivants le receveur 



Page 107/112 

Le service “ following ” a la même sémantique que la notion de noeuds suivants en Xpath : il renvoie 

l'ensemble des objets suivants l'objet du receveur 


 

Voir aussi 

followingSibling(), preceding()

3.9.5 - followingSibling 

followingSibling() 

Renvoie l'ensemble des frères suivants du receveur. 

Receveur 

Retour 




La liste des frères suivants du receveur 



Page 108/112 

Le service “ followingSibling ” a la même sémantique que la notion de frères suivants en Xpath : il renvoie 

l'ensemble des objets suivants, des“ petits-frères ”, de l'objet du receveur 


: Je suis le dernier descendant, le benjamin, de mon parent. 

Voir aussi 

following(), precedingSibling()

3.9.6 - parent 

parent() 

Renvoie le parent immédiat du receveur. 

Receveur 

Retour 




Le parent de l'objet courant 



Page 109/112 

Le service “ parent ” a la même sémantique que la notion de parent en Xpath : il renvoie le parent immédiat 

(un seul niveau) de l'objet du receveur. 


: renvoie la classe qui contient l'attribut “ monAttribut ” 

Voir aussi 

eContainer(), ancestor()

3.9.7 - preceding 

preceding() 

Renvoie tous les objets précédant le receveur. 

Receveur 

Retour 




La liste des objets précédant l'objet courant 



Page 110/112 

Le service “ preceding ” a la même sémantique que la notion de noeuds précédents en Xpath : il renvoie 

l'ensemble des objets qui précède l'objet du receveur 


 

Voir aussi 

precedingSibling(), following()

3.9.8 - precedingSibling 

precedingSibling() 

Renvoie l'ensemble des frères précédents du receveur. 

Receveur 

Retour 




La liste des frères précédents du receveur 



Page 111/112 

Le service “ precedingSibling ” a la même sémantique que la notion de frères précédents en Xpath : il 

renvoie l'ensemble des objets précédents, des“ grands-frères ”, de l'objet du receveur 


: Je suis le premier descendant, l'aîné de mon parent 

Voir aussi 

preceding(), followingSibling()

3.9.9 - self 

self() 


Receveur 

Retour 







Page 112/112 

Le service “ self ” a la même sémantique que la notion de noeud courant en Xpath : il renvoie l'objet 

courant, c'est à dire le receveur. 


Voir les exemples dans current() 

Voir aussi 

current()

Acceleo 2.6 : Référence

Create successful ePaper yourself

Delete template?

Save as template?