Définition de syntaxes concrètes graphiques

Transcription

Définition de syntaxes concrètes graphiques
BE 4
UTM M2 ICE
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
mai 2012
Définition de syntaxes concrètes graphiques
À l’instar d’une syntaxe concrète textuelle, une syntaxe concrète graphique fournit un moyen
de pouvoir visualiser et/ou éditer plus agréablement et efficacement un modèle. Nous allons
utiliser les outils développés dans le cadre du projet GMF (Eclipse Graphical Modeling Framework 1 ). Ils permettent de définir une syntaxe graphique pour une langage de modélisation décrit
en Ecore et d’engendrer un éditeur graphique intégré à Eclipse. L’éditeur graphique Ecore utilisé
pour visualiser et éditer les modèles Ecore a été développé avec GMF.
1
Définir une syntaxe graphique pour SimplePDL avec GMF
Le point de départ est la définition de la syntaxe abstraite du DSML. Elle est définie par un
modèle Ecore (le méta-modèle) éventuellement complété par des contraintes (exprimées en OCL
par exemple). Nous allons considérer le méta-modèle de SimplePDL (figure 1).
Process
processElements
0..*
name: EString[1]
ProcessElement
elements
0..*
Guidance
text: EString[1]
<< enumeration >>
WorkSequenceType
startToStart
finishToStart
startToFinish
finishToFinish
WorkDefinition
predecessor
1
name: EString[1]
successor
1
linksToSuccessors
WorkSequence
0..*
linksToPredecessors linkType: WorkSequenceType[1]
0..*
F IGURE 1 – Nouveau méta-modèle de SimplePDL
La deuxième étape consiste à définir la syntaxe concrète graphique souhaitée. Par exemple,
on peut souhaiter la syntaxe proposée à la figure 2. GMF permet de représenter des modèles
graphiquement sous la forme d’un graphe composé de nœuds et d’arcs. Il est bien sûr possible de
choisir la forme d’un nœud (rectangle, ellipse, etc.) et la forme d’un arc (décoration à l’extrémité,
tracé du trait, etc.).
Définir une syntaxe graphique c’est donc :
1. http ://www.eclipse.org/modeling/gmf/
BE 4
1/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
F IGURE 2 – Éditeur possible pour SimplePDL
1. définir comment représenter les éléments d’un modèle. Dans le cas de SimplePDL, on
décide de représenter :
– une activité (WorkDefinition) par un rectangle aux coins arrondis,
– une dépendance (WorkSequence) par un arc orienté entre deux activités.
– une aide (Guidance) par un rectangle,
– l’aide sera attachée aux éléments qu’elle décrit par une flèche en traits interrompus à
l’instar des annotations en UML.
2. définir la correspondance entre les éléments du modèle et les éléments graphiques. Cette
correspondance doit être bidirectionnelle pour permettre de visualiser un modèle (il faut
savoir à quels élément graphiques correspondent les éléments du métamodèle) et l’éditer (il
faut connaître l’impact de l’ajout, la modification ou la suppression d’un élément graphique
sur le modèle correspondant.
3. si on veut définir un éditeur, il faut avoir une palette qui permet de créer les différents
éléments graphiques de la syntaxe graphique.
GMF propose un méta-modèle pour chacun de ces trois éléments.
– GMF Graph (extension .gmfgraph) décrit les éléments graphiques de la syntaxe concrète
sous la forme de nœuds (Node), arcs (Connection) et labels (Label) ainsi que leur représentation graphique (Figure).
– GMF Tool (extension .gmftool) décrit la palette sous la forme de groupes (Group) d’outils
(Tools). Un outil correspond à la création d’un élément graphique.
BE 4
2/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
– GMF Map (extension .gmfmap) décrit les liens entre un élément graphique de GMF Graph,
l’outil de GMF Tool qui permet de le créer et les éléments du modèle Ecore.
Enfin, quand ces trois modèles sont définis, il est possible d’engendrer un dernier modèle .gmfgen
qui permet de contrôler la génération de l’éditeur graphique.
Dans la suite, nous allons voir comment construire un éditeur (donc définir une syntaxe concrète graphique) pour SimplePDL. À travers quelques extensions précises, nous entrapercevrons
aussi les possibilités offertes par GMF.
Exercice 1 : Création d’un projet GMF
Commençons par créer le projet adéquat.
1.1 Créer un projet GMF (Graphical Modeling Framework > GMF Project). Ce projet contient
en particulier un répertoire model qui est destiné à recevoir les différents modèles qui permettront
d’engendrer l’éditeur.
1.2 Une vue spécifique a été développée pour suivre la création d’un éditeur avec GMF. Il s’agit
de la vue General > GMF Dashboard. Elle peut être sélectionnée lors de la création du projet en
la cochant sur le dernier écran. Elle peut être ouverte ensuite en faisant Window > Show view >
Others... puis en sélectionnant General > GMF Dashboard.
L’intérêt de cette vue est de montrer le processus à suivre pour arriver à la construction d’un
éditeur graphique avec GMF. Plus précisément, chaque boîte correspond à un modèle à construire
et les actions associées (Select, Edit Create, etc.) et chaque flèche correpond à une dépendance
entre ces modèles. On peut cliquer sur les actions associées à un modèle ou à une dépendance.
Ceci masque les actions Eclipse correspondante qui consiste généralement à créer un nouveau
type de modèle et lancer l’assistant associé.
On retrouve bien :
1. la syntaxe abstraite : Domain Model, le modèle métier,
2. le genmodel qui contrôle la génération de l’infrastructure associée au langage (Domain
Gen Model, le « genmodel »)
3. le modèle graphique : Graphical Def Model (GMF Graph),
4. le modèle des outils et donc la palette : Tooling Def Model (GMF Tool),
5. le modèle de correspondance entre la syntaxe abstraite, le modèle graphique et le modèle
des outils : Mapping Model (GMF Map).
6. le modèle de génération de l’éditeur : Diagram Editor Gen Model. Équivalent au genmodel
de EMF, il contrôle les paramètres de l’éditeur qui sera engendré.
Ce dernier modèle propose d’ailleurs l’action Generate diagram editor.
Exercice 2 : Définition de la syntaxe abstraite
La première étape consiste à définir la syntaxe abstraite.
2.1 On pourrait définir maintenant la syntaxe abstraite sous la forme d’un modèle Ecore. Nous
allons en fait récupérer le modèle SimplePDL.ecore déjà développé et le placer dans le répertoire
model du projet GMF.
BE 4
3/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
2.2 Cliquer sur l’action Select de l’étape Domain Model et sélectionner le modèle SimplePDL.ecore.
On commence par sélectionner le méta-modèle parmi ceux proposés puis sa localisation (si le
même modèle apparaît à plusieurs endroits).
Exercice 3 : Génération de l’infrastructure EMF pour SimplePDL
Appuyons nous sur le dashboard.
3.1 Cliquer sur Derive qui apparaît sur la dépendance entre Domain Model et Domain Gen
Model et répondre aux questions de l’assistant.
3.2 Faire Generate all en cliquant à droite sur l’élément racine du fichier SimplePDL.genmodel
qui vient d’être ouvert.
Exercice 4 : Définition du modèle graphique
Maintenant, on peut soit définir la palette, soit le modèle graphique. Commençons par le modèle
graphique. Il s’agit de définir les « unités lexicales » de la syntaxe graphique : les nœuds, les
arcs et les labels ainsi que leur organisation (positionnement des labels par rapport aux nœuds en
particulier).
4.1 Cliquer sur le Derive qui mène à Graphical Def Model et renseigner l’assistant :
– le nom du modèle créé est SimplePDL.gmfgraph (déjà initialisé), faire Next
– le domain modèle (syntaxe abstraite) est déjà initialisée (SimplePDL.ecore). Il faut cependant initialiser l’élément qui correspond au diagramme. Ici, il s’agit de Process. Faire Next.
– le dernier écran propose tous les éléments et les références de la syntaxe abstraite. Il s’agit
de décider si un élément graphique leur correspond. L’élément graphique est soit un nœud,
soit un arc, soit un label.
Dans notre cas, WorkDefinition et Guidance correspondent à des nœuds. WorkSequence
correspond à un arc (qui relira deux WordDefinition). La référence elements de Guidance
est aussi un lien (reliant l’aide aux éléments sur lesquels elle porte). Enfin, les références
name de WorkDefinition, linkType de WorkSequance et text de Guidance sont des labels.
Faire Finish. Le modèle est créé.
4.2 Regarder le modèle correspondant. La racine est un élément Canvas. Il contient un élément
Figure Gallery dont les fils décrivent les caractéristiques graphiques des nœuds, des arcs et des
labels. Nous y reviendrons. Il contient également des Node, des Connexion et des Diagram Label
qui correspondent naturellement aux nœuds, arcs et labels.
Regardons le Node WorkDefinition. Il définit (voir la vue Property) son nom (Name, ici
WorkDefinition) et la figure associée (Figure, ici Figure Descriptor WorkDefinition).
De manière similaire, un élément Connection possède un nom et une figure associée. On
peut le constater sur Connection WorkSequence. Ces deux informations se retrouvent aussi sur
un Diagram Label avec quelques autres.
Sous l’élément Figure Gallery sont données les descriptions des différentes figures référencées
par les éléments précédents. Notons que pour des nœuds, il est possible de définir une gestionnaire de placement et les éléments internes.
4.3 Valider le modèle en cliquant à droite sur l’élément racine.
Exercice 5 : Définition de la palette
Définissons maintenant le palette.
BE 4
4/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
5.1 Cliquer sur le Derive qui mène à Tooling Def Model et renseigner l’assistant :
– le nom du modèle créé est SimplePDL.gmftool (déjà initialisé), faire Next
– le domain modèle (syntaxe abstraite) est déjà initialisée (SimplePDL.ecore). Il faut cependant initialisé l’élément qui correspond au diagramme. Ici, il s’agit de Process. Faire Next.
– le dernier écran propose tous les éléments et les références de la syntaxe abstraite. Il s’agit
de décider quels éléments donneront lieu à un bouton de création. Ainsi il faut cocher nœud
pour WorkDefinition et Guidance et lien pour WorkSequence et Guidance.elements.
L’élément racine de ce modèle est Tool Registry qui est composé de Palette. Une palette est
structurée en groupes (Tool Group) qui regroupent des outils de création (Creation Tool). Les
deux seuls attributs d’un Creation Tool sont le titre (qui apparaîtra dans la palette de l’éditeur) et
une description.
5.2 Valider le modèle en cliquant à droite sur l’élément racine.
Exercice 6 : Définition du modèle de liens
Le dernier modèle (GMF Graph) consiste à établir les liens entre les trois modèles précédents
(syntaxe abstraite, outils et graphique).
6.1 Créer le modèle GMF Map. Cliquer sur le Combine qui mène à Mapping Model et renseigner l’assistant. Ils faut s’appuyer sur les modèles déjà créés (les champs correspondants sont
correctement initialisés). Il faut simplement penser à sélectionner Process comme élément correspondant au diagramme. Sur le dernier écran, on sélectionne les éléments qui vont décrire les
correspondances. Ils sont classés en nœuds et liens (arcs). Dans les nœuds, il ne faut garder que
WorkDefinition et Guidance. WorkSequence doit être déplacé dans la partie liens (As Link). Dans
les liens, il faut supprimer (Remove) tous les éléments sauf WorkSequence que l’on vient d’y
mettre et elements.
Quand on sélectionne un élément on peut voir dans l’encadré Structure les liens avec la
syntaxe abstraite : l’élément correspondant, l’endroit ou sera stocké un nouvel élément et d’autres
informations.
Dans l’encadré Visual apparaît le lien vers l’élément de GMF Graph correspondant.
Faire Finish après avoir regardé les caractéristiques des différents éléments encore présents
dans les boîtes de sélection.
6.2 Vérifier le modèle GMF Map. Le modèle SimplePDL.ecore est ouvert avec l’éditeur arborescent. On remarque qu’au fur et à mesure que l’on ouvre les éléments, de nouvelles ressources
apparaissent en bas (SimplePDL.ecore, SimplePDL.gmfgraph, etc.) car elles sont utilisés par les
éléments ouverts.
L’élément racine est Mapping qui contient plusieurs éléments fils.
– Canvas Mapping définit les correspondances générales entre les différents modèles : la
syntaxe abstraite (Domain Model), les outils (Misc > Palette) et le modèle graphique (Visual Presentation).
– Top Node Reference décrit les liens relatifs à un élément représenté comme un nœud. Par
exemple celui qui correspond à Guidance. La propriété Containment Feature indique où
sera stocké l’élément correspondant dans le modèle SimplePDL.
Le fils Node Mapping fait le lien avec la syntaxe abstraite (Domain meta information /
Elemet qui est initialisé avec Guidance), avec la visualisation (Visual representation, le
BE 4
5/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
Diagram Node est Node Guidance) et les outils (La valeur de Tool devrait être Creation
Tool Guidance !).
Des informations similaires sont présentes sur le fils Feature Label.
Vérifier aussi le Top Node Reference correspondant à WorkDefinition et en particulier la
propriété Tool de son fils !
– Link Mapping permet de décrire les correspondances induites par un arc. Elles sont plus
compliquées que les nœuds car il faut potentiellement considérer l’élément source du lien,
l’élément cible, voir le lien lui-même.
Pour le Link Mapping de WorkSequence, il faut indiquer qu’une WorkSequence :
– correspond à l’élément WorkSequence de SimplePDL,
– est stockée dans la référence Process.processElements,
– relie activité source (la précédente) à une activité cible (la suivante). Il faut donc initialiser Source Feature avec WorkSequence.predecessor et Target Feature avec WorkSequence.successor,
– est visualisée comme un Connexion WorkSequence définie dans le modèle GMF Graph.
C’est donc avec cette valeur qu’il faut initialiser Diagram Link,
– est créée par l’outil Creation Tool WorkSequence. Le vérifier !
En revanche, pour le Link Mapping qui correspond à GuidanceElements, on n’y a pas à
renseigner les champs Element et Containment Feature puisqu’il n’a pas d’élément correspondant dans la syntaxe abstraite. Il faut simplement dire que l’élément cible est stocké
dans Guidance.elements.
6.3 Valider le modèle en cliquant à droite sur l’élément racine.
Exercice 7 : Génération du modèle de génération de l’éditeur
On peut maintenant engendrer le modèle qui contrôle la génération de l’éditeur. Cliquer Transform sur le Dashboard.
Alternativement, il suffit de sélectionner le fichier SimplePDL.gmfmap, cliquer à droite et
exécuter Create generator model.
Exercice 8 : Génération de l’éditeur
Sur le Dashboard, il suffit de cliquer sur Generate Diagram Editor.
Alternativement, il suffit de sélectionner le fichier SimplePDL.gmfgen, cliquer à droite et
exécuter Generate diagram code.
Exercice 9 : Utilisation de l’éditeur engendré
Pour avoir accès à l’éditeur engendré, il faut lancer un second Eclipse à partir du premier. Dans
un projet (par exemple General > Project), on peut alors faire New > Example... > SimplePDL
Diagram.
On peut alors utiliser l’éditeur graphique SimplePDL engendré.
Exercice 10 : Quelques améliorations sur l’éditeur
Voyons à travers des exemples simples quelques extensions que l’on peut apporter simplement à
l’éditeur graphique SimpleDPL. Attention, à chaque fois que l’on modifie les modèles (graphique,
outil, liens), il faut engendrer de nouveau le fichier .gmfgen puis l’éditeur. Attention à sauvegarder les fichiers avant.
BE 4
6/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
10.1 Changer la représentation des activités. Dans le modèle gmfgraph, on peut changer l’aspect
des éléments graphiques. Par exemple pour avoir des rectangles aux coins arrondis pour les activités, il suffit de remplacer Rectangle pour RoundedRectangle comme fils de Figure Descriptor
WorkDefinitionFigure. Techniquement, le plus simple est d’utiliser un fichier texte et de modifier
la définition de l’élément actualFigure dont la valeur de l’attribut name est WorkDefinitionFigure en remplaçant Rectangle par RoundedRectangle. Si on le fait sous l’éditeur arborescent, il
faut supprimer l’élément et ses fils. Il faudra donc recréer les fils !
On peut aussi mettre la taille du trait à 2 (Line Width) et augmenter la taille de l’arrondi
(mettre Corner Height et Corner Width à 20).
10.2 Changer l’aspect des dépendances. On va ajouter une flèche pour indiquer le sens de
la dépendance. Il suffit d’ajouter un élément Polyline Decoration comme fils à l’élément Polyline Connection WorkSequenceFigure. On peut appeler WorkSequenceFigureArrow cet élément
(propriété Name).
Il suffit alors d’initialiser la propriété Target Decoration de Polyline Connection WorkSequenceFigure avec ce nouvel élément.
On aurait pu aussi se resservir de Polyline Decoration GuidanceElementsTargetDecoration
(mais il serait préférable de lui donner un nom plus général tel que Arrow).
10.3 Changer l’aspect des liens d’aide. On peut mettre les liens partant de Guidance en traits
interrompus en sélectionnant la valeur LINE_DASH de Line Kind de Polyline connection GuidanceElementFigure.
10.4 Réorganiser la palette. Modifier la palette de manière à avoir deux groupes. L’un appelé
Elements donne accès à la création des WorkDefinition et Guidance. L’autre appelé Links permet
de créer une dépendance (WorkSequence) et le lien qui relie une Guidance à un ProcessElement.
10.5 Interdire les dépendances réflexives. Il est possible d’interdire les références réflexives en
associant une propriété Link Constraint sous Link Mapping WorkSequence. On ajoute ensuite
un fils Target End Constraint. On peut alors initialiser la propriété Body avec l’expression OCL
suivante :
self <> oppositeEnd
10.6 Ajouter un audit. Un audit permettra de faire un Diagram / Validate dans l’éditeur engendré. Il faut :
– ajouter sous Mapping un fils Audit Container, Audit Rule. On peut définir une règle qui
vérifie que le nom d’une activité n’est pas vide :
self.name.size() > 0
Il faut indiquer le contexte de la contrainte. Aussi, on ajoute un frère à la contrainte (Domain Element Target) et on initialise la propriété Element avec WorkDefinition.
– mettre à True les propriétés de l’élément Gen Diagram ... suivantes dans le fichier SimplePDL.gmfgen :
– Validation Enabled
– Validation Decorators
Mettre Validation Provider Priority à Medium.
BE 4
7/8
I NGÉNIERIE D IRIGÉE PAR LES M ODÈLES
Définition de syntaxes concrètes graphiques
– dans l’éditeur engendré, on peut alors faire Diagram > Validate. Dans la vue Error.log les
erreurs sont signalées. Les WorkDefinition qui ne respectent pas la propriétés sont marquées d’une croix rouge.
2
Application aux réseaux de Petri
Exercice 11 Définir un éditeur graphique pour les réseaux de Petri.
BE 4
8/8