Eclipse Modeling Tools

Transcription

1 Laboratoire d'analyse et d'architecture des Systèmes Eclipse Modeling Tools Génération d'un éditeur graphique évolué Résumé: Un éditeur graphique est généré à partir d'un méta modèle «Ecore». Cet éditeur visualise: - les arcs sous forme de flèches, - Le nom des arcs, - Les noeuds sous la forme d'ellipse. Mots clés: Eclipse, INDIGOT, Eclipse Modeling Tools, EMF, méta modèle ecore, Editeur graphique Serge Bachmann CNRS LAAS 2I Serge Bachmann Page 1/44

2 Sommaire 1 Introduction Spécification Initialisation Sélectionner «Domain Model» (Fichier : *.ecore) Dériver «Domain Gen Model» (Fichier : *.genmodel) Générer le code associé au méta modèle Générer «Tooling Def Model» (Fichier : *.gmftool) Générer «Graphical Def Model» (Fichier : *.gmfgraph) Éditer «Graphical Def Model» Ajout des flèches «>» en bout d'arc Visualisation des nœuds elliptiques Générer «Mapping Model» (Fichier : *.gmfmap) Modifier le «Mapping» Éditer les propriétés du mapping Editer «Graphe.gmfmap» Affichage nom de l'arc Générer «Diagram Editor Gen Model» (Fichier : *.gmfgen) Générer l'éditeur de diagramme Test de l'éditeur Créer une configuration d'exécution Créer un projet Éditer un graphe Accès au modèle édité Création de la commande «View Model» Création d'un «package» pour recevoir le code de la commande Création de l'arbre des extensions Le code du «handler» Test Conclusions Licence...44 CNRS LAAS 2I Serge Bachmann Page 2/44

3 Informations Générale Fichier source document: E:\FORMATION_Eclipse\modeling-indigo- SR1\EMT\DOCUMENTATION\GenerationEditeurGraphiqueBis.odt Version Eclipse: INDIGO version 3.7 This package contains framework and tools to leverage models : an Ecore graphical modeler (class-like diagram), Java code generation utility for RCP applications and the EMF Framework, model comparison support, support for XSD schemas, OCL and graphical modeler runtimes. It includes a complete SDK, developer tools and source code. Download: eclipse-modeling-indigo-win32.zip Date de création: 25 août 2011 Date d'impression: 6 décembre 2011 Workspace:...\INDIGO\EMT\WORKSPACES\GenerationEditeurGraphique Plate forme Windows 32 CNRS LAAS 2I Serge Bachmann Page 3/44

4 Introduction 1 Introduction 1.1 Spécification A partir du méta modèle précédemment défini on génère un éditeur graphique de graphe évolué. 1.2 Initialisation Ce reporter au quatre premiers paragraphes du document «Eclipse Modeling Tools - Génération d'un éditeur graphique». Seul diffère le workspace : E:\FORMATION_Eclipse\modeling-indigo-SR1\EMT\WS\GenerationEditeurGraphiqueBis On suppose donc que «GMF» est installé, qu'un projet «GMF» est créé, que le modèle «ecore» est défini. CNRS LAAS 2I Serge Bachmann Page 4/44

5 2 Pour cela nous allons utiliser le «Dashboard» comme dans la version simple de l'éditeur: Afin de personnaliser l'éditeur nous éditerons: le «Graphical DefModel» et le «Mapping Model» CNRS LAAS 2I Serge Bachmann Page 5/44

6 2.1 Sélectionner «Domain Model» (Fichier : *.ecore) Sélectionner le projet «exemple.graphe.gmf». Cliquer «Select» dans: Sélectionner le méta- modèle «ecore»: Cliquer «OK». On obtient: CNRS LAAS 2I Serge Bachmann Page 6/44

7 2.2 Dériver «Domain Gen Model» (Fichier : *.genmodel) Cliquer «Derive»: Création du générateur: Cliquer «Next>». CNRS LAAS 2I Serge Bachmann Page 7/44

8 On utilise un modèle «ecore»: Cliquer «Next >» Cliquer «Load» puis «Next >» CNRS LAAS 2I Serge Bachmann Page 8/44

9 Ne pas modifier «New EMF Generator Model Package Selection»: Cliquer «Finish» On obtient: et dans le projet «exemple.graphe.gmf» sous model apparaît un nouveau fichier: CNRS LAAS 2I Serge Bachmann Page 9/44

10 2.3 Générer le code associé au méta modèle Le fichier «Graphe.genmodel» est un fichier de génération, l'ouvrir en édition si nécessaire. Utiliser la commande «Generate All» du menu contextuel de l'éditeur pour générer le code: Le code généré est placé dans «exemple.graphe.gmf\src» et dans trois projets: Nous revenons au «GMF Dashboard» CNRS LAAS 2I Serge Bachmann Page 10/44

11 2.4 Générer «Tooling Def Model» (Fichier : *.gmftool) Cliquer «Derive»: Cliquer «Next >» CNRS LAAS 2I Serge Bachmann Page 11/44

12 Dans «New Domain Model» cliquer «Load» et sélectionner «Graphe»: Cliquer «Next >» Dans «New Tooling Definition» ne pas modifier la sélection: Cliquer «Finish» CNRS LAAS 2I Serge Bachmann Page 12/44

13 On obtient: Le fichier «Graphe.gmftool» : CNRS LAAS 2I Serge Bachmann Page 13/44

14 2.5 Générer «Graphical Def Model» (Fichier : *.gmfgraph) Cliquer «Derive»: on obtient: Cliquer «Next >». CNRS LAAS 2I Serge Bachmann Page 14/44

15 Dans «New Domain Model» cliquer «Load» puis sélectionner «Graphe»: Cliquer «Next >». Dans «New Graphical Definition» conserver les choix proposés: Cliquer «Finish» CNRS LAAS 2I Serge Bachmann Page 15/44

16 On obtient: Si on clique «Edit» on visualise le fichier «Graphe.gmfgraph» avec «GMFGraph model editor» : 2.6 Éditer «Graphical Def Model» Ajout des flèches «>» en bout d'arc Pour cela nous allons éditer le fichier «Graphe.gmfgraph» Si ce n'est déjà fait, sélectionner le projet «exemple.graphe.gmf». Dans: cliquer «Edit». Agrandir si nécessaire la zone d'édition et ouvrir l'arborescence. CNRS LAAS 2I Serge Bachmann Page 16/44

17 Faire : On crée: Éditer la «property» «Name» de «Polyline Decoration», faire une sauvegarde: CNRS LAAS 2I Serge Bachmann Page 17/44

18 Sélectionner «Polyline Connection ArcFigure». Pour la «property» «Target Decoration» sélectionner «Polyline Decoration TargetDecoration» : Faire une sauvegarde Visualisation des nœuds elliptiques Éditer dans le projet «exemple.graphe.gmf» le fichier «Graphe.gmfgraph»: On efface «Rectangle NoeudFigure» et on crée à la place «Ellipse» CNRS LAAS 2I Serge Bachmann Page 18/44

19 On initialise la «property» Name de «Elipse», après sauvegarde on obtient: On crée sous «Eclipse NoeudFigure» un «Flow Layout» Sans changer les «properties». CNRS LAAS 2I Serge Bachmann Page 19/44

20 Ce qui donne: Sous «Ellipse NoeudFigure» on crée un»label»: CNRS LAAS 2I Serge Bachmann Page 20/44

21 Initialiser les «properties», faire une sauvegarde: Initialisé les «properties» de «Child Acces getfigurenull»: Faire une sauvegarde. CNRS LAAS 2I Serge Bachmann Page 21/44

22 Finalement le fichier «Graphe.gmfgraph» devient: On peut en obtenir une version textuelle : <?xml version="1.0" encoding="utf-8"?> <gmfgraph:canvas xmi:version="2.0" xmlns:xmi=" xmlns:xsi=" xmlns:gmfgraph=" name="graphe"> <figures name="default"> <figures xsi:type="gmfgraph:polylinedecoration" name="targetdecoration"/> <descriptors name="noeudfigure"> <actualfigure xsi:type="gmfgraph:ellipse" name="noeudfigure"> <layout xsi:type="gmfgraph:flowlayout"/> <children xsi:type="gmfgraph:label" name="noeudnomfigure" text="<...>"/> </actualfigure> <accessors accessor="getfigurenoeudnomfigure" figure="//@figures.0/@descriptors.0/@actualfigure/@children.0"/> </descriptors> <descriptors name="arcfigure"> <actualfigure xsi:type="gmfgraph:polylineconnection" name="arcfigure" targetdecoration="//@figures.0/@figures.0"> <children xsi:type="gmfgraph:label" name="arcnomfigure" text="<...>"/> </actualfigure> <accessors figure="//@figures.0/@descriptors.1/@actualfigure/@children.0"/> </descriptors> </figures> <nodes name="noeud" figure="noeudfigure"/> CNRS LAAS 2I Serge Bachmann Page 22/44

23 <connections name="arc" figure="arcfigure"/> <labels name="noeudnom" figure="noeudfigure" <labels name="arcnom" figure="arcfigure" </gmfgraph:canvas> CNRS LAAS 2I Serge Bachmann Page 23/44

24 2.7 Générer «Mapping Model» (Fichier : *.gmfmap) Cliquer «Combine»: Cliquer «Next >» CNRS LAAS 2I Serge Bachmann Page 24/44

25 Dans «Create GMFMap model - Select Domain Model» cliquer «Load» puis sélectionner «Graphe»: Cliquer «Next >» Cliquer «Load» puis «Next >» CNRS LAAS 2I Serge Bachmann Page 25/44

26 On obtient: Cliquer «Load» puis «Next >». On obtient: Remarque : Si Arc apparaît avant Noeud dans Nodes la génération sera incorrecte. Aucune raison apparente explique cette inversion. Il faut reprendre la génération avec le «Dashboard» CNRS LAAS 2I Serge Bachmann Page 26/44

27 2.7.1 Modifier le «Mapping». 1. Dans «Links» sélectionner «origine...», faire «Remove» «origine», faire «Remove» «extremite» 2. Dans «Nodes» sélectionner Arc. Faire passer «Arc» dans «Links» en utilisant «As link -->» Remarque: Les commandes s'appliquent aux objets sélectionnés. Attention : ne pas faire «Finish»! CNRS LAAS 2I Serge Bachmann Page 27/44

28 2.7.2 Éditer les propriétés du mapping Sélectionner dans «Links» «Arc», cliquer «Change...» et sélectionner les valeurs des «properties»: Remarque: pour sélectionner les valeurs cliquer la zone à initialiser: puis utiliser le bouton contenant le triangle pointé vers le bas pour faire apparaître toutes les possibilités. Cliquer «OK». Dans «Create GMFMap model - Mapping» faire «Finish». CNRS LAAS 2I Serge Bachmann Page 28/44

29 On obtient: Le fichier Graphe.gmfmap : 2.8 Editer «Graphe.gmfmap» Cliquer «Edit» : CNRS LAAS 2I Serge Bachmann Page 29/44

30 2.8.1 Affichage nom de l'arc Cette modification à pour but d'afficher le nom des arcs. Faire un clic droit sur «LinkMapping...» et sélectionner «New Child > Feature Label Mapping» On obtient: Sélectionner «Feature Label Mapping false» et initialisé ses «proprerties»: Faire une sauvegarde. Le fichier «Graphe.gmfmap» visualisé avec «GMFMap Model Editor» : CNRS LAAS 2I Serge Bachmann Page 30/44

31 La version textuelle de «Graphe.gmfmap» : <?xml version="1.0" encoding="utf-8"?> <gmfmap:mapping xmi:version="2.0" xmlns:xmi=" xmlns:xsi=" xmlns:ecore=" xmlns:gmfmap=" xmlns:gmftool=" <nodes> <containmentfeature href="graphe.ecore#//graphe/listenoeuds"/> <ownedchild> <domainmetaelement href="graphe.ecore#//noeud"/> <labelmappings xsi:type="gmfmap:featurelabelmapping"> <diagramlabel href="graphe.gmfgraph#noeudnom"/> <features href="graphe.ecore#//noeud/nom"/> </labelmappings> <tool xsi:type="gmftool:creationtool" href="graphe.gmftool#//@palette/@tools.0/@tools.0"/> <diagramnode href="graphe.gmfgraph#noeud"/> </ownedchild> </nodes> <links> <domainmetaelement href="graphe.ecore#//arc"/> <labelmappings xsi:type="gmfmap:featurelabelmapping" editpattern=""> <diagramlabel href="graphe.gmfgraph#arcnom"/> <features href="graphe.ecore#//arc/nom"/> </labelmappings> <containmentfeature href="graphe.ecore#//graphe/listearcs"/> <tool xsi:type="gmftool:creationtool" href="graphe.gmftool#//@palette/@tools.0/@tools.1"/> <diagramlink href="graphe.gmfgraph#arc"/> <sourcemetafeature xsi:type="ecore:ereference" href="graphe.ecore#//arc/origine"/> <linkmetafeature xsi:type="ecore:ereference" href="graphe.ecore#//arc/extremite"/> </links> <diagram> <diagramcanvas CNRS LAAS 2I Serge Bachmann Page 31/44

32 href="graphe.gmfgraph#graphe"/> <domainmodel href="graphe.ecore#/"/> <domainmetaelement href="graphe.ecore#//graphe"/> <palette </diagram> </gmfmap:mapping> CNRS LAAS 2I Serge Bachmann Page 32/44

33 2.9 Générer «Diagram Editor Gen Model» (Fichier : *.gmfgen) Cliquer «Transform»: On obtient : Dans «model» on à maintenant: CNRS LAAS 2I Serge Bachmann Page 33/44

34 2.10 Générer l'éditeur de diagramme Cliquer «Generate diagram editor» Cliquer «OK». Le projet «exemple.graphe.gmf.diagram» est créé. CNRS LAAS 2I Serge Bachmann Page 34/44

35 Test de l'éditeur 3 Test de l'éditeur 3.1 Créer une configuration d'exécution Faire: Créer la nouvelle configuration d'exécution de type: Eclipse Application en double cliquant «Eclipse Application». Nommer la configuration, cliquer «Apply»: Cliquer «Run». CNRS LAAS 2I Serge Bachmann Page 35/44

36 Test de l'éditeur Une nouvelle plateforme «Eclipse» est lancée avec pour «workspace»: «E:\FORMATION_Eclipse\modeling-indigo-SR1\EMT\WS\runtime-GenerationEditeurGraphiqueBis» On ferme la fenêtre «Welcome» et quelques vues: 3.2 Créer un projet Faire: sélectionner: Faire «Next >». CNRS LAAS 2I Serge Bachmann Page 36/44

37 Test de l'éditeur On le nomme: Cliquer «Finish». 3.3 Éditer un graphe On lance l'éditeur de diagramme «Graphe Diagram»: CNRS LAAS 2I Serge Bachmann Page 37/44

38 Test de l'éditeur Sélectionner: Cliquer «Next >». On nomme le diagramme: Cliquer «Next >» CNRS LAAS 2I Serge Bachmann Page 38/44

39 Test de l'éditeur On garde le nom fichier: Cliquer «Finish». On édite un graphe : Faire une sauvegarde et fermer la plate-forme de test. CNRS LAAS 2I Serge Bachmann Page 39/44

40 Accès au modèle édité 4 Accès au modèle édité Nous souhaitons accéder au modèle édité afin de réaliser, par exemple, un traitement du modèle. Nous allons créer une commande qui affiche dans un message le graphe édité. 4.1 Création de la commande «View Model» Création d'un «package» pour recevoir le code de la commande Dans le projet «exemple.graphe.gmf.diagram» on crée sous «src» un «package» destiné à recevoir le code (Handler) associé à la commande. Nommer le «package»: Cliquer «Finish» le «package» est créé. CNRS LAAS 2I Serge Bachmann Page 40/44

41 Accès au modèle édité Création de l'arbre des extensions Pour créer la commande dans le projet «exemple.graphe.gmf.diagram» on ouvre le «plugin Manifest Editor» onglet «Extension» afin de compléter l'arbre des extensions avec: On retrouve l'ensemble des «Extension Details» associées dans le fichier «plugin.xml»: <extension point="org.eclipse.ui.commands"> <command id="exemple.graphe.gmf.diagram.viewmodel" name="view Model"> </command> </extension> <extension point="org.eclipse.ui.handlers"> <handler class="moncode.viewmodel" commandid="exemple.graphe.gmf.diagram.viewmodel"> </handler> </extension> <extension point="org.eclipse.ui.menus"> <menucontribution allpopups="false" locationuri="menu:org.eclipse.ui.main.menu?after=additions"> <menu id="processmodel" label="process Model"> <command commandid="exemple.graphe.gmf.diagram.viewmodel" style="push"> </command> </menu> </menucontribution> </extension> Remarque : on peut directement éditer «plugin.xml». Ne pas oublier de créer l'handler et de faire une sauvegarde générale Le code du «handler» package moncode; import java.util.iterator; import graphe.arc; import graphe.noeud; import graphe.diagram.navigator.graphedomainnavigatoritem; import graphe.impl.grapheimpl; import org.eclipse.core.commands.executionevent; import org.eclipse.core.commands.executionexception; import org.eclipse.core.commands.ihandler; CNRS LAAS 2I Serge Bachmann Page 41/44

42 Accès au modèle édité import org.eclipse.core.commands.ihandlerlistener; import org.eclipse.emf.common.util.elist; import org.eclipse.jface.dialogs.messagedialog; import org.eclipse.jface.viewers.iselection; import org.eclipse.jface.viewers.treeselection; import org.eclipse.swt.widgets.shell; import org.eclipse.ui.handlers.handlerutil; public class ViewModel implements IHandler public void addhandlerlistener(ihandlerlistener handlerlistener) { // TODO Auto-generated method stub public void dispose() { // TODO Auto-generated method stub } Shell public Object execute(executionevent event) throws ExecutionException { shell = HandlerUtil.getActiveWorkbenchWindow(event).getShell(); ISelection selection = HandlerUtil.getCurrentSelection(event); Object first = ((TreeSelection) selection).getfirstelement(); GrapheImpl graphe; String nomgraphe; try { GrapheDomainNavigatorItem graf = (GrapheDomainNavigatorItem) first; nomgraphe= (graf.getparent().tostring()).substring(2); graphe = (GrapheImpl)graf.getEObject(); } catch (Exception e) { MessageDialog.openError(shell, "View Model", "In view \"Project Explorer\" select: \"*.graphe/graphe\""); return null; } vuemodel(nomgraphe, graphe); return null; } private void vuemodel(string nomgraphe, GrapheImpl graphe){ String message = new String("Nom du graphe: "+ nomgraphe +"\n"); message += "Liste des noeuds\n"; EList<Noeud> listenoeuds = graphe.getlistenoeuds(); Iterator<Noeud> in = listenoeuds.iterator(); while (in.hasnext()){ } Noeud n = in.next(); message += " "+n.getnom()+"\n"; } message += "Liste des arcs\n"; EList<Arc> listearcs = graphe.getlistearcs(); Iterator<Arc> ia = listearcs.iterator(); while (ia.hasnext()){ Arc a = ia.next(); message += " "+a.getnom()+ "("+a.getorigine().getnom()+ "->"+a.getextremite().getnom()+")\n"; } MessageDialog.openInformation(shell, "View Model", public boolean isenabled() { // TODO Auto-generated method stub return true; public boolean ishandled() { // TODO Auto-generated method stub return true; public void removehandlerlistener(ihandlerlistener handlerlistener) { // TODO Auto-generated method stub CNRS LAAS 2I Serge Bachmann Page 42/44

43 Accès au modèle édité } } 4.2 Test On lance le test: On retrouve le graphe précédemment édité. On ouvre «G1.graphe» et on sélectionne «Graphe»: On sélectionne notre commande: Le message suivant s'affiche: Si la sélection ne correspond pas à un «Graphe» le message d'erreur ci-dessous est visualisé: CNRS LAAS 2I Serge Bachmann Page 43/44

44 Conclusions 5 Conclusions Le «DashBoard» facilite le processus de génération de l'éditeur. Cependant, comme nous avons pu le voir, tout changement dans la représentation du graphe implique des modifications non triviales. Pour plus de précisions se reporter au livre: eclipse Modeling Project A Domain-Specific Language (DSL) Toolkit auteur: Richard C. Gronback ISBN-13: ou à la documentation en ligne. 6 Licence La licence «créative commons» : s'applique à ce document. CNRS LAAS 2I Serge Bachmann Page 44/44