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