Author: fdesbois Date: 2009-11-24 18:06:20 +0100 (Tue, 24 Nov 2009) New Revision: 719 Added: trunk/maven-eugene-plugin/src/site/en/ trunk/maven-eugene-plugin/src/site/en/rst/ trunk/maven-eugene-plugin/src/site/en/rst/index.rst trunk/maven-eugene-plugin/src/site/fr/ trunk/maven-eugene-plugin/src/site/fr/rst/ trunk/maven-eugene-plugin/src/site/fr/rst/index.rst trunk/maven-eugene-plugin/src/site/site_en.xml trunk/maven-eugene-plugin/src/site/site_fr.xml trunk/src/site/en/ trunk/src/site/en/rst/ trunk/src/site/en/rst/generatorHelp.rst trunk/src/site/en/rst/index.rst trunk/src/site/en/rst/maven-plugin.rst trunk/src/site/fr/ trunk/src/site/fr/resources/ trunk/src/site/fr/resources/images/ trunk/src/site/fr/resources/images/Hotel.objectmodel.png trunk/src/site/fr/resources/images/Hotel.png trunk/src/site/fr/resources/images/ObjectModel.png trunk/src/site/fr/resources/images/ObjectModel_Generator.png trunk/src/site/fr/resources/images/ObjectModel_Interfaces.png trunk/src/site/fr/resources/images/StateModel.png trunk/src/site/fr/resources/images/plugin_choix.png trunk/src/site/fr/resources/images/plugin_menu.png trunk/src/site/fr/resources/images/plugin_newdepot.png trunk/src/site/fr/resources/images/plugin_typeinstall.png trunk/src/site/fr/resources/images/plugin_utilisation_editeur.png trunk/src/site/fr/resources/models/ trunk/src/site/fr/resources/models/buix.guix trunk/src/site/fr/resources/models/exemple.topiaModel trunk/src/site/fr/resources/xmi/ trunk/src/site/fr/resources/xmi/ObjectModel.zuml trunk/src/site/fr/resources/xmi/objectmodel.zargo trunk/src/site/fr/rst/ trunk/src/site/fr/rst/DevUIDoc.rst trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst trunk/src/site/fr/rst/FAQ.rst trunk/src/site/fr/rst/ObjectModel.rst trunk/src/site/fr/rst/Todo.rst trunk/src/site/fr/rst/index.rst trunk/src/site/fr/rst/maven-plugin.rst trunk/src/site/fr/rst/plugineclipse.rst trunk/src/site/site_en.xml trunk/src/site/site_fr.xml Removed: trunk/eugene/src/site/en/rst/generatorHelp.rst trunk/eugene/src/site/fr/rst/DevUIDoc.rst trunk/eugene/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst trunk/eugene/src/site/fr/rst/FAQ.rst trunk/eugene/src/site/fr/rst/ObjectModel.rst trunk/eugene/src/site/fr/rst/Todo.rst trunk/eugene/src/site/fr/rst/plugineclipse.rst trunk/maven-eugene-plugin/src/site/site.xml trunk/src/site/site.xml Modified: trunk/eugene/src/site/en/rst/index.rst trunk/eugene/src/site/fr/rst/index.rst trunk/eugene/src/site/site_en.xml trunk/eugene/src/site/site_fr.xml trunk/pom.xml Log: Refactor site for new mavenpom usage with two folders for languages Deleted: trunk/eugene/src/site/en/rst/generatorHelp.rst =================================================================== --- trunk/eugene/src/site/en/rst/generatorHelp.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/en/rst/generatorHelp.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,89 +0,0 @@ - -How to create a UML model for use with Eugene ---------------------------------------------- - -In Poseidon, - - Create an empty project - - Rename root package to your application name (used by ???) - - create a package hierarchy according to your company name and project organisation (eg : org.codelutin.jdevis.entities) - - Create a class diagram is this package, so that classes you will define to it will belong to this package at creation. - - Make a model of your entities : - - All entities must be stereotyped 'entity' - - You may use both class and interface - - You may set several taggedValues on all items : - - doc : documentation related to this item, used for javadoc comments (not used yet) - - You may set several taggedValues on classes : - - asText : OCL expression used as for toString() method generation (eg : this.firstName+" "+this.lastName) - - You may set several taggedValues on attributes : - - readonly : boolean that indicates if change must be made impossible on this attribute (used for setter generation) - - mandatory : boolean that indicates if this attribute is mandatory (used to build a minimal not empty constructor) - - defines : boolean that indicates if this attribute is needed for defining the class (used for default UIs) - - primaryKey : boolean that indicates if this attribute is part of the primary key for the class (not used yet) - - indexed : boolean that indicates if it must be possible to search items by this attribute (not used yet) - - - -TopiaUI : ---------- - -<topiaUI xmlns="http://www.codelutin.org/topia/topiaUI" name="XXX"> - <content> - <item> - <containmentProperties> - <property name="_containementPropertyName_" type="_containementPropertyType_">XXX</property> - </containmentProperties> - <widget name="XXX" type="_widgetType_"> - <properties> - <property name="_propertyName_" type="_propertyType_">XXX</property> - </properties> - <signals> - <signal name="_signalName_" handler="XXX"/> - </signals> - <content> - <item> - ... - </item> - ... - </content> - </widget> - </item> - ... - </content> -</topiaUI> - -widgetType : - gridBag - panel - scrollPane - table - label - textfield - button - -properties : - minimumWidth of type int - minimumHeight of type int - preferedWidth of type int - preferedHeight of type int - maximumWidth of type int - maximumHeight of type int - text of type String (default to "") - editable of type boolean (default to true) - borderType of type String = {"SoftBevelBorder", "EtchedBorder"} - borderDepth of type String = {"LOWERED", "RAISED"} - borderText of type String - -containmentProperties : - gridX of type int (default to 0) - gridY of type int (default to 0) - gridWidth of type int (default to 1) - gridHeight of type int (default to 1) - anchor of type String = {"CENTER", "NORTH", "SOUTH", "EAST", "WEST", "NORTHEAST", "NORTHWEST", "SOUTHEAST", "SOUTHWEST"} (default to CENTER) - fill of type String = {"HORIZONTAL", "VERTICAL", "BOTH", "NONE"} (default to BOTH) - weightX of type double (default to 1.0) - weightY of type double (default to 1.0) - insetTop of type int (default to 2) - insetBottom of type int (default to 2) - insetLeft of type int (default to 2) - insetRight of type int (default to 2) - Modified: trunk/eugene/src/site/en/rst/index.rst =================================================================== --- trunk/eugene/src/site/en/rst/index.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/en/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -2,56 +2,6 @@ Eugene ====== -:Authors: Arnaud THIMEL -:Contact: thimel@codelutin.com -:Revision: $Revision$ -:Date: $Date$ +See details on `parent`_ site - -.. contents:: - - -Project origin -============== - -Eugene was born after a research of an easy-to-use code generator -oriented on "in memory" models. But the research ended by a failure. - -Analysed projects were : - -- Jostraca ; -- EMF ; -- ... - -Code Generation were chosen instead of Introspection because it allows to use -the compilation processes and therefore to validate the generated code. Even if -the initial need was to generate Java source code, Eugene is able to -generate any type of code. - - - -Technical part -============== - -Eugene allows using a set of generators. These generators are abstract -of any specificity enabling to adapt them to indicidual needs. - - -By default, Eugene has two implementations of these generators : - -- ObjectModelGenerator (generation from an object model) ; -- UIModelGenerator (generation from a graphic model). - -Each of these models has its own specificities due to its strucure and working -mode... - -Anyway, these generators are unuseful without generation templates. Templates -are files allowing to determinate what will be the generated content according -to the initial model. Thanks to LutinProcessor_, these templates are written -with a syntax close to the JSP syntax mixing Java and generated code. The goal -of LutinProcessor is to tranform the templates by replacing JSP code by the -matching Java code. Obtained Java classes can be compiled and so become -independants. - - -.. _LutinProcessor: http://lutinprocessor.labs.libre-entreprise.org/ +.. _parent: ../../en/index.html \ No newline at end of file Deleted: trunk/eugene/src/site/fr/rst/DevUIDoc.rst =================================================================== --- trunk/eugene/src/site/fr/rst/DevUIDoc.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/DevUIDoc.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,103 +0,0 @@ -======= -UIModel -======= - -:Authors: Aurelie MAZELIER -:Revision: $Revision$ -:Date: $Date$ - - -.. contents:: - - -Model UIModel -============= - -En parcourant un fichier xml, il est possible de construire un objet -UIModel. Cet objet est défini par les interfaces suivantes. - - -Interfaces ----------- - -- UIModel : - - - version XML - - root de type UIModelObject - - le nom du package - - liste des objets du model - -- UIModelObject : - - - nom - - type - - un UIModelObject parent - - un UIModel - - une liste d'arguments - - une liste de propriétés - - une liste d'évènements - - une liste d'enfants - -- UIModelArgument : - - - une liste d'arguments - -- UIModelProperty : - - - un nom - - une valeur (de différents type : int, float ...) - - un index - -- UIModelEvent : - - - le nom de la addListenerMethod - - le nom de la listenerInterface - - le nom de la listenerMethod - - le nom du handler - - le nom de la eventProperty - -- UIModelChild : - - - un enfant UIModelObject - - la contrainte de l'enfant de type UIModelConstraint - -- UIModelConstraint : - - - une valeur de type Object ou String - - -Implantations -------------- - -Il existe deux implantations de ces interfaces. - - -impl -~~~~ - -Cette première implantation permet d'obtenir un UIModel lors -du parcours du fichier xml de type uimodel par le parser -XMLParser. - - -xml -~~~ - -Cette deuxième implantation permet d'obtenir un UIModel lors -du parcours du fichier xml de type javaxml par le parser -JavaXMLParser. - - -JavaXMLParser -------------- - -Ce parser permet de parcourir des fichiers javaxml afin d'obtenir un -objet UIModel. Ce parser utilise dom4j. - - -Générateurs -=========== - -- Génération d'objet UIModel (UIModelGenerator). Ce générateur utilise les classes précédentes afin d'obtenir un objet UIModel en fonction des fichiers xml. A partir de cet objet UIModel, il est possible de lancer la génération. Ces générateurs sont utilisées dans Topia pour générer les fichiers java à partir de l'objet UIModel. - -- Génération d'objet UIModel (UIModelGeneratorWithCapitalizeName). Ce générateur est une sous classe du premier. Il est possède une méthode permettant de mettre la première lettre en majuscule du nom d'un objet, d'une propriété... Deleted: trunk/eugene/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst =================================================================== --- trunk/eugene/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,82 +0,0 @@ -========================= -Principe de la génération -========================= - -Il y a deux façon de voir la génération. - -La première que l'on rencontre le plus -souvent génère des fichiers avec des sections à -modifier par le développeur. Ces sections sont marquées par des commentaires -que le générateur interprète pour savoir qu'il n'a pas le droit de modifier -cette partie de code. - -La deuxième qui à pour principe: - -- le générateur ne doit jamais modifier les fichiers de l'utilisateur. -- l'utilisateur ne doit jamais modifier le code généré - -De cette façon les choses sont clairement séparé, et cela est possible sans -utilisation d'artifice perturbant le développeur grâce au nouveau langage à -objet et à l'héritage. - -La grosse différence n'est pas dans les générateurs eux même mais dans les -templates de génération. Si tous les générateurs de la première catégorie -peuvent très bien servir pour faire de la génération de la seconde, -l'inverse n'est pas vrai. Car la seconde catégorie demande des générateurs -beaucoup plus simple, ce qui est d'ailleur un avantage pour la maintenance. - -Code Lutin utilise un générateur du deuxième type: Eugene - -Quelques générateurs de la première catégorie: - -- Acceleo (Obeo) -- Pragmatic (Argia) - -Les principes de Eugene -======================= - -- le générateur ne doit jamais modifier les fichiers de l'utilisateur. -- l'utilisateur ne doit jamais modifier le code généré -- le modèle est toujours la source (pas de reverse, pas de modification du - modèle par le générateur -- être le plus simple possible (simple à maintenir) -- s'appuyer sur les normes (XMI) -- pouvoir utiliser plusieurs fichiers XMI pour la même génération -- ne pas mettre dans le modèle des choses techniques (ex: type pour la base de - données) mais dans un fichier de propriété à coté du modèle. -- avoir une couche d'abstraction du XMI pour évité la modification des - templates si la version de XMI change (XMLObjectModel) -- s'appuyer sur un modèle mémoire simple (ObjectModel écrit spécifiquement - car aucun modèle simple n'a été trouvé) -- s'appuyer sur un langage puissant et connu des développeurs (Java) -- ne jamais mélanger le code généré et le code utilisateur -- pouvoir générer n'importe quelle type de fichier (XML, Java, texte, ...) -- être facilement intégrable dans une phase de génération/compilation - (task ant, plugin maven) -- être indépendant d'un outil de développement spécifique (chacun à le droit de - choisir l'éditeur qu'il souhaite). - -Défaut de la première solution -============================== - -- il faut prévoir partout ou l'utilisateur pourrait souhaiter ajouter du - code. Par exemple dans Pragmatic, on ne peut pas utiliser les imports car il - n'y a pas de section utilisateur à cet endroit, il faut donc à chaque fois - écrire le package lorsque l'on souhaite utiliser une classe non encore - importée. - -- le développeur voit beaucoup de code qu'il n'a pas le droit de modifier - ce qui complexifie la vue du développeur pour rien - -Défaut des générateurs le plus souvent rencontré -================================================ - -- Les générateurs au lieu d'utiliser un langage et façon de faire que tous - les développeurs connaissent réinvente leur propre syntaxe et langage. - -Eugene lui utilise seulement du Java et les tags JSP (<%, <%=, %>). -De cette façon le générateur reste simple pas de langage à développer et -parser. L'utilisateur qui connait Java connait le langage de template. Et -surtout l'utilisateur n'est pas limité par le langage développé -spécifiquement pour les templates. - Deleted: trunk/eugene/src/site/fr/rst/FAQ.rst =================================================================== --- trunk/eugene/src/site/fr/rst/FAQ.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/FAQ.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,16 +0,0 @@ -=== -FAQ -=== - -Comment convertir les modèles UML de Poseidon vers ArgoUML ? -============================================================ - -Il faut sauver le modèle sous Poseidon en XMI, on bien l'extraire du -fichier .zmul qui est en fait un fichier zip:: - - xlstproc -o <argo-file>.xmi poseidon2argouml.xsl <poseidon-file>.xmi - -Ensuite dans ArgoUML ouvrez le fichier généré. - -Les diagrammes ne sont pas convertie, il faut donc les recréer a partir des -classes en faisant du drag&drop. Deleted: trunk/eugene/src/site/fr/rst/ObjectModel.rst =================================================================== --- trunk/eugene/src/site/fr/rst/ObjectModel.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/ObjectModel.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,92 +0,0 @@ -=========== -ObjectModel -=========== - -:Authors: Arnaud Thimel, Florian Desbois -:Contact: eugene-devel@list.nuiton.org ou eugene-users@list.nuiton.org -:Revision: $Revision$ -:Date: $Date$ - - -.. contents:: - - -Introduction -============ - -Le générateur ObjectModelGenerator est prévu pour lire et analyser des modèles -objets puis générer du code à partir de ceux-ci. En UML, un modèle objet est -représenté par un diagramme de classe. Cette vision des modèles objet étant très -répandue, elle sert de base à l'ObjectModelGenerator (il est à noter cependant -que ce n'est pas obligatoire). - -Partons donc du principe que l'on dispose d'un modèle (diagramme de classe) créé -à l'aide d'un outil de modélisation au format XMI (XML Metadata Interchange). - -La génération de code se fait ensuite en trois étapes : - -- Epuration du XMI en un code XML ne conservant que les informations utiles ; -- Mise en mémoire du modèle simplifié ; -- Application des templates / génération de code. - - -Epuration du modèle XMI -======================= - -La plupart des outils de modélisation décrivent leur modèle en XMI. Or le XMI -est trop verbeux pour être compréhensible aisement. - -Eugene propose une tranformation XSLT permettant ainsi d'obtenir un XML -épuré décrivant le modèle et ne conservant que l'essentiel des informations. - -Parmi les informations extraites, on peut citer : - -- Objets (classes, classes abtraites, interfaces) -- Attributs (nom, type, visibilité, ...) -- Relations entre les classes (toutes multiplicités, navigabilité, classes d'association, ...) -- Opérations (nom, type de retour, noms et types des arguments, exceptions levées, ...) -- Stéréotypes - -A partir du diagramme suivant : - -.. image:: ../images/Hotel.png - -On obtient un ObjectModel tel que : - -.. image:: ../images/Hotel.objectmodel.png - - -Modèle mémoire -============== - -Une fois le XMI ramené à un XML compréhensible, le modèle est chargé en -mémoire afin de subir la génération. - -Ainsi, le modèle instancié est basé sur le diagramme de classes (méta-modèle) suivant : - -.. image:: ../images/ObjectModel.png - -Les interfaces disponibles pour les générateurs sont les suivantes : - -.. image:: ../images/ObjectModel_Interfaces.png - -ObjectModelGenerator : - -.. image:: ../images/ObjectModel_Generator.png - -Application des templates -========================= - -Chaque template est à lui seul un générateur qui hérite de ObjectModelGenerator. -Toute partie de ce générateur peut donc être surchargée permettant ainsi une -forte personnalisation des générateurs. Le rôle de l'ObjectModelGenerator est -donc de parcourir le modèle et à chaque élément clé du modèle, (model, classes -interfaces, classifier) les méthodes correspondantes sont appelées. Par défaut, -ces méthodes décrites dans le générateur de base sont vide, et il n'en ressort -donc aucun code généré. Les templates ont donc pour but de surcharger ses -méthodes et décrire le code qui va être généré. - -Les templates peuvent être de toutes sortes car ils peuvent générer un fichier -différent par modèle, par interface, par classe ou encore par classifier (souche -commune aux classes et interfaces). De plus, ils peuvent indifféremment générer -du code Java / XML ou encore tout autre type de code (texte ou autre...). Deleted: trunk/eugene/src/site/fr/rst/Todo.rst =================================================================== --- trunk/eugene/src/site/fr/rst/Todo.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/Todo.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,115 +0,0 @@ -==== -TODO -==== - - -:Revision: $Revision$ -:Date: $Date$ - - -Idées ou choses à faire -======================= - -- support des InnerClasses (en xmi argo: la classe est declarer dans une classe - dans un element UML:Namespace.ownedElement) (`Evolution #59`_ ) - -- support des static (tout element declarer dans une class/interface: methode, - attribut, enumeration, class, ...) - (en xmi argo: ownerScope='classifier' ou ownerScope='instance') (`Evolution #58`_ ) - -.. _Evolution #59: http://www.nuiton.org/issues/show/59 -.. _Evolution #58: http://www.nuiton.org/issues/show/58 - -- peut-etre faire des tests unitaires avec http://juxy.tigris.org/ pour le xls - -- Permettre de faire du 'model to model' avant la generation - -Model to Model -============== - -(2009-10-19 : En cours de developpement : `branches/1.0.1-javabuilder`_ ) - -.. _branches/1.0.1-javabuilder: http://nuiton.org/repositories/browse/eugene/branches/1.0.1-Javabuilder - -Pour tout ce qui est génération de classe Java, le principe de base d'Eugene -est de dire que le développeur écrit directement ce qu'il souhaite voir dans -le fichier final. - -Cela pose quelques difficultés: - -- difficulté de prévoir les imports -- difficulté d'éviter la génération de deux méthodes ayant le même nom - -L'idée serait alors de constuire la classe Java souhaitée au final en appelant -des méthodes (addImport, addMethod, addAttribute, ...). Ceci nous donnerait -alors un nouveau modèle mémoire dont on demanderait la génération à un -générateur sans inteligence qui se contenterait d'écrire le code Java modélisé. - -L'avantage est que pour chaque méthode à ajouter on peut demander avant si elle -n'a pas déjà été ajoutée et ainsi potentiellement la renomé avant de l'inclure. -D'ajouter de façon automatique tous les imports des arguments des méthodes, ... - -Pour pouvoir faire cela, nous pourrions nous baser sur ObjectModel, mais des -ajouter doivent être fait: - -- pouvoir indiquer sur une Class une série d'import. -- pouvoir ajouter un message de licence -- pouvoir ajouter sur une méthode sont code source - -Ce dernier élément est le plus problèmatique, car il deviendrait pénible de -devoir instancier tout le code de la méthode en objet et on perdrait l'idée -de départ d'Eugene. - -Dans eugène il est déjà possible de modifier la transformation des tags de -génération '/\*{' et '}\*/' qui par défaut génère un 'ouput.write("...");' -Dans notre cas, il faudrait quelque chose comme 'method.addCode("...");' ou -encore plus simplement '"..." +' ce qui pourrait donner:: - - addImport(MonObject.class); - method.addCode( - /*{ int i = 0; - i = 1+2; - MonObject result = new MonObject(result); - return result; - }*/ - ); - -qui deviendrait:: - - addImport(MonObject.class); - method.addCode( - "int i = 0;\n" + - "i = 1+2;\n" + - "MonObject result = new MonObject(result);\n" + - "return result;\n" - ); - -On garde la facilte d'écriture du code à générer et on permet d'ajouter -facilement des imports dont on aurait besoin dans le coprs de la méthode. Aucun -traitement complexe du code de la méthode n'est donc nécessaire. - -Ce nouveau mode de génération ne serait qu'une moyen complémentaire de la -génération actuelle. - -Travail a faire: - -- ajout d'objet dans ObjectModel -- ajout de méthode de modification dans ObjectModel -- création d'un template de génération d'un POJO (génération direct d'un modèle) - -Il serait toute fois dommage d'ajouter tout un ensemnble de setter sur les -interfaces d'ObjectModel qui le rendrait moins clair pour les générateurs. -Il faut donc trouver une solution pour permettre l'instanciation et la -modification de classe implantant l'ObjectModel sans pour autant les ajouter -au interface. - -Une idée pourrait-être l'utilisation de Helper qui permette de créer et modifier -le modèle:: - - ObjectModelClass clazz = ObjectModelHelper.createClass(); - ObjectModelOperation method = ObjectModelHelper.addMethod( - clazz, "name", "typeRetour", "paramName", "typeParam"); - ObjectModelHelper.addImport("java.util.List"); - ObjectModelHelper.addCode(method, - /*{ blablabla - }*/ Modified: trunk/eugene/src/site/fr/rst/index.rst =================================================================== --- trunk/eugene/src/site/fr/rst/index.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -2,79 +2,6 @@ Eugene ====== -.. contents:: +Voir details sur le site `parent`_ - -Origine du projet ------------------ - -Eugene est né à la suite d'une recherche de générateur de code basé sur -un modèle mémoire simple qui s'est terminée par un échec. - -Les projets alors étudiés étaient alors entre autres : - -- Jostraca ; -- EMF ; -- ... - -Le choix de la génération de code par rapport à l'introspection a été fait car -la génération code permet de passer par l'étape compilation et donc de -validation du code généré. En effet, si le besoin était initialement porté sur -de la génération de code Java, Eugene a été pensé pour générer tout type -de code. - - -Côté technique --------------- - -Eugene permet l'utilisation d'un ensemble de générateurs. Ces -générateurs sont abstraits de toute spécificité permettant ainsi de les adapter -en fonction des besoins. - -Par défaut, Eugene propose trois implantations de ces générateurs : - -- ObjectModelGenerator (génération à partir d'un modèle objet) ; -- StateModelGenerator (génération à partir d'un modèle d'états) ; -- UIModelGenerator (génération à partir d'un modèle graphique). - -Chacun de ces modèles a ses propres spécificités liés à sa structure et son mode -de fonctionnement... - -Cependant, ces générateurs sont inutiles sans des templates de génération. Les -templates sont les fichiers qui vont permettre de déterminer quel sera le -contenu généré en fonction du modèle initial. Grâce à NuitonProcessor_, ces -templates sont écrit avec une sytaxe proche de la syntaxe JSP en imbriquant les -portions de code Java avec les portions de code généré. Le rôle de -NuitonProcessor_ est de transformer ces templates en remplaçant la syntaxe JSP par -la syntaxe Java correpondante. Les classes Java obtenues peuvent donc être -compilées et deviennent autonomes. - -.. _NuitonProcessor: http://maven-site.nuiton.org/processor/ - -Règle ant ---------- - -Voici un exemple d'utilisation de la règle ant. - -:: - - <taskdef name="generator" classname="org.nuiton.eugene.GeneratorTask" - classpath="${compile.classpath}:${targetbuild}:${resources}" /> - - <target name="generate" description="generate"> - <generator srcdir="${modelDir}" destdir="${targetgen}" - resolver="org.nuiton.exemple.ResourceResolver" - templates="org.nuiton.example.JavaBeanGenerator" - properties="defaultPackage=org.nuiton,fullPackagePath=org.nuiton,extraPackages=org.nuiton" - classpath="${compile.classpath}:${targetbuild}:${resources}" /> - </target> - -Dans cette exemple, un template de génération sera apliqué sur tous les -fichiers. - -Plugin maven ------------- - -Un plugin maven est disponnible à l'adresse suivante -http://maven-site.nuiton.org/eugene/maven-eugene-plugin . Il permet l'utilisation -depuis maven de Eugene. +.. _parent: ../../fr/index.html Deleted: trunk/eugene/src/site/fr/rst/plugineclipse.rst =================================================================== --- trunk/eugene/src/site/fr/rst/plugineclipse.rst 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/fr/rst/plugineclipse.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -1,44 +0,0 @@ -Installation du plugin LutinGenerator -===================================== - -Ce guide détail comment installer le plugin eclipse LutinGenerator via -l'update site (assitant d'instalation de plugins). - -Installation ------------- - -Ouvrez l'assitant d'installation de plugin via le menu -(Help/Software Updates/Find and install...). - -.. image:: ../images/plugin_menu.png - -Sur la fenêtre suivante sélectionnez "Search for new features to install". - -.. image:: ../images/plugin_typeinstall.png - -Une nouvelle fenêtre s'affiche, sélectionnez "New remote site" pour ajouter le -dépot "LutinGenerator". - -L'adresse du dépot à utiliser est : - -:: - - http://lutingenerator.labs.libre-entreprise.org/eclipse/ - -.. image:: ../images/plugin_newdepot.png - - -Sélectionnez ensuite ce dépot et cliquez sur "Finish". - -Installez ensuite la dernière version disponible et redémarrez eclipse: - -.. image:: ../images/plugin_choix.png - - -Utilisation ------------ - -Pour disposer de la coloration des templates, cliquez droit sur un fichier -source java et sélectionnez "Open with > / LutinGenerator Template Editor" - -.. image:: ../images/plugin_utilisation_editeur.png \ No newline at end of file Modified: trunk/eugene/src/site/site_en.xml =================================================================== --- trunk/eugene/src/site/site_en.xml 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/site_en.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -8,21 +8,9 @@ <body> <breadcrumbs> - <item name="${project.name}" href="${project.url}" /> + <item name="${project.name}" href="index.html" /> </breadcrumbs> - - <links> - <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/" /> - <item name="[fr" href="../fr/index.html" /> - <item name="en]" href="index.html" /> - </links> - - <menu ref="parent"/> - <menu name="User"> - <item href="index.html" name="Home"/> - </menu> - <menu ref="reports"/> </body> Modified: trunk/eugene/src/site/site_fr.xml =================================================================== --- trunk/eugene/src/site/site_fr.xml 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/eugene/src/site/site_fr.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -8,51 +8,9 @@ <body> <breadcrumbs> - <item name="${project.name}" href="${project.url}" /> + <item name="${project.name}" href="index.html" /> </breadcrumbs> - <links> - <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/" /> - <item name="[fr" href="index.html" /> - <item name="en]" href="../en/index.html" /> - </links> - - <menu ref="parent"/> - - <menu name="Utilisateur"> - <item href="index.html" name="Accueil"/> - <item href="DiscussionSurTypeDeGeneration.html" name="Génération"/> - <item href="FAQ.html" name="FAQ"/> - </menu> - - <menu name="Developpeur"> - <item name="ObjectModel" href="ObjectModel.html"/> - <item name="UIModel" href="DevUIDoc.html"/> - <item name="Plugin Eclipse" href="plugineclipse.html"/> - <item name="Todo" href="Todo.html"/> - </menu> - - <menu name="Téléchargement"> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}.jar" - name="Librairie (jar)"/> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}-javadoc.jar" - name="Javadoc (jar)"/> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}-sources.jar" - name="Sources (jar)"/> - <item href="http://${platform}/projects/list_files/eugene" name="Archives" /> - </menu> - - <menu name="Trackers"> - <item name="Bugs" href="${project.issueManagement.url}?query_id=2"/> - <item name="Améliorations" href="${project.issueManagement.url}?query_id=1"/> - <item name="Aide" href="${project.issueManagement.url}?query_id=3"/> - </menu> - - <menu name="Liens"> - <item name="Nuiton-processor" href="http://maven-site.nuiton.org/processor"/> - <item name="ToPIA" href="http://maven-site.nuiton.org/topia"/> - </menu> - <menu ref="reports"/> </body> Added: trunk/maven-eugene-plugin/src/site/en/rst/index.rst =================================================================== --- trunk/maven-eugene-plugin/src/site/en/rst/index.rst (rev 0) +++ trunk/maven-eugene-plugin/src/site/en/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,11 @@ +=================== +Maven EUGene plugin +=================== + +See `goals details`_ + +.. _goals details: plugin-info.html + +Go back to `EUGene`_ + +.. _EUGene: ../../en/index.html \ No newline at end of file Added: trunk/maven-eugene-plugin/src/site/fr/rst/index.rst =================================================================== --- trunk/maven-eugene-plugin/src/site/fr/rst/index.rst (rev 0) +++ trunk/maven-eugene-plugin/src/site/fr/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,11 @@ +=================== +Maven EUGene plugin +=================== + +Voir le détails des `goals`_ + +.. _goals: plugin-info.html + +Retour sur `EUGene`_ + +.. _EUGene: ../../fr/index.html \ No newline at end of file Deleted: trunk/maven-eugene-plugin/src/site/site.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site.xml 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/maven-eugene-plugin/src/site/site.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -1,43 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - </bannerLeft> - - <body> - <links> - <item name="Eugene" href="../eugene"/> - </links> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}" /> - </breadcrumbs> - - <menu ref="parent"/> - - <menu name="Utilisateur"> - <item href="index.html" name="Accueil"/> - <item name="Goals" href="plugin-info.html"> - <item name="zargo2xmi" href="zargo2xmi-mojo.html"/> - <item name="xmi2statemodel" href="xmi2statemodel-mojo.html"/> - <item name="xmi2objectmodel" href="xmi2objectmodel-mojo.html"/> - <item name="generate" href="generate-mojo.html"/> - <item name="copyVersionFiles" href="copyVersionFiles-mojo.html"/> - <item name="help" href="help-mojo.html"/> - </item> - </menu> - - <menu name="Téléchargement"> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}.jar" - name="Librairie (jar)"/> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}-javadoc.jar" - name="Javadoc (jar)"/> - <item href="${repository.home.url}/org/nuiton/eugene/${project.artifactId}/${project.version}/${project.build.finalName}-sources.jar" - name="Sources (jar)"/> - </menu> - - <menu ref="reports"/> - - </body> -</project> Added: trunk/maven-eugene-plugin/src/site/site_en.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site_en.xml (rev 0) +++ trunk/maven-eugene-plugin/src/site/site_en.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,17 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="${project.name}"> + + <bannerLeft> + <name>${project.name}</name> + </bannerLeft> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="index.html" /> + </breadcrumbs> + + <menu ref="reports"/> + + </body> +</project> Added: trunk/maven-eugene-plugin/src/site/site_fr.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site_fr.xml (rev 0) +++ trunk/maven-eugene-plugin/src/site/site_fr.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,17 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="${project.name}"> + + <bannerLeft> + <name>${project.name}</name> + </bannerLeft> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="index.html" /> + </breadcrumbs> + + <menu ref="reports"/> + + </body> +</project> Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/pom.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -10,7 +10,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom</artifactId> - <version>1.1.0</version> + <version>1.1.1-SNAPSHOT</version> </parent> <artifactId>eugene</artifactId> @@ -245,14 +245,30 @@ <ant.version>1.7.1</ant.version> <!--Multilanguage maven-site --> - <maven.site.locales>es,en,fr</maven.site.locales> + <maven.site.locales>fr,en</maven.site.locales> </properties> <build> <defaultGoal>install</defaultGoal> - + <plugins> + <plugin> + <groupId>org.nuiton</groupId> + <artifactId>maven-helper-plugin</artifactId> + <executions> + <execution> + <id>generate-site-index</id> + <goals> + <goal>generate-site-index</goal> + </goals> + <configuration> + <locales>${maven.site.locales}</locales> + </configuration> + </execution> + </executions> + </plugin> + </plugins> <pluginManagement> <plugins> Copied: trunk/src/site/en/rst/generatorHelp.rst (from rev 694, trunk/eugene/src/site/en/rst/generatorHelp.rst) =================================================================== --- trunk/src/site/en/rst/generatorHelp.rst (rev 0) +++ trunk/src/site/en/rst/generatorHelp.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,89 @@ + +How to create a UML model for use with Eugene +--------------------------------------------- + +In Poseidon, + - Create an empty project + - Rename root package to your application name (used by ???) + - create a package hierarchy according to your company name and project organisation (eg : org.codelutin.jdevis.entities) + - Create a class diagram is this package, so that classes you will define to it will belong to this package at creation. + - Make a model of your entities : + - All entities must be stereotyped 'entity' + - You may use both class and interface + - You may set several taggedValues on all items : + - doc : documentation related to this item, used for javadoc comments (not used yet) + - You may set several taggedValues on classes : + - asText : OCL expression used as for toString() method generation (eg : this.firstName+" "+this.lastName) + - You may set several taggedValues on attributes : + - readonly : boolean that indicates if change must be made impossible on this attribute (used for setter generation) + - mandatory : boolean that indicates if this attribute is mandatory (used to build a minimal not empty constructor) + - defines : boolean that indicates if this attribute is needed for defining the class (used for default UIs) + - primaryKey : boolean that indicates if this attribute is part of the primary key for the class (not used yet) + - indexed : boolean that indicates if it must be possible to search items by this attribute (not used yet) + + + +TopiaUI : +--------- + +<topiaUI xmlns="http://www.codelutin.org/topia/topiaUI" name="XXX"> + <content> + <item> + <containmentProperties> + <property name="_containementPropertyName_" type="_containementPropertyType_">XXX</property> + </containmentProperties> + <widget name="XXX" type="_widgetType_"> + <properties> + <property name="_propertyName_" type="_propertyType_">XXX</property> + </properties> + <signals> + <signal name="_signalName_" handler="XXX"/> + </signals> + <content> + <item> + ... + </item> + ... + </content> + </widget> + </item> + ... + </content> +</topiaUI> + +widgetType : + gridBag + panel + scrollPane + table + label + textfield + button + +properties : + minimumWidth of type int + minimumHeight of type int + preferedWidth of type int + preferedHeight of type int + maximumWidth of type int + maximumHeight of type int + text of type String (default to "") + editable of type boolean (default to true) + borderType of type String = {"SoftBevelBorder", "EtchedBorder"} + borderDepth of type String = {"LOWERED", "RAISED"} + borderText of type String + +containmentProperties : + gridX of type int (default to 0) + gridY of type int (default to 0) + gridWidth of type int (default to 1) + gridHeight of type int (default to 1) + anchor of type String = {"CENTER", "NORTH", "SOUTH", "EAST", "WEST", "NORTHEAST", "NORTHWEST", "SOUTHEAST", "SOUTHWEST"} (default to CENTER) + fill of type String = {"HORIZONTAL", "VERTICAL", "BOTH", "NONE"} (default to BOTH) + weightX of type double (default to 1.0) + weightY of type double (default to 1.0) + insetTop of type int (default to 2) + insetBottom of type int (default to 2) + insetLeft of type int (default to 2) + insetRight of type int (default to 2) + Copied: trunk/src/site/en/rst/index.rst (from rev 694, trunk/eugene/src/site/en/rst/index.rst) =================================================================== --- trunk/src/site/en/rst/index.rst (rev 0) +++ trunk/src/site/en/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,57 @@ +====== +Eugene +====== + +:Authors: Arnaud THIMEL +:Contact: thimel@codelutin.com +:Revision: $Revision$ +:Date: $Date$ + + +.. contents:: + + +Project origin +============== + +Eugene was born after a research of an easy-to-use code generator +oriented on "in memory" models. But the research ended by a failure. + +Analysed projects were : + +- Jostraca ; +- EMF ; +- ... + +Code Generation were chosen instead of Introspection because it allows to use +the compilation processes and therefore to validate the generated code. Even if +the initial need was to generate Java source code, Eugene is able to +generate any type of code. + + + +Technical part +============== + +Eugene allows using a set of generators. These generators are abstract +of any specificity enabling to adapt them to indicidual needs. + + +By default, Eugene has two implementations of these generators : + +- ObjectModelGenerator (generation from an object model) ; +- UIModelGenerator (generation from a graphic model). + +Each of these models has its own specificities due to its strucure and working +mode... + +Anyway, these generators are unuseful without generation templates. Templates +are files allowing to determinate what will be the generated content according +to the initial model. Thanks to LutinProcessor_, these templates are written +with a syntax close to the JSP syntax mixing Java and generated code. The goal +of LutinProcessor is to tranform the templates by replacing JSP code by the +matching Java code. Obtained Java classes can be compiled and so become +independants. + + +.. _LutinProcessor: http://lutinprocessor.labs.libre-entreprise.org/ Added: trunk/src/site/en/rst/maven-plugin.rst =================================================================== --- trunk/src/site/en/rst/maven-plugin.rst (rev 0) +++ trunk/src/site/en/rst/maven-plugin.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,10 @@ +=================== +Maven-eugene-plugin +=================== + +Usage in pom.xml +---------------- + +See `goals`_ details. + +.. _goals: plugin-info.html \ No newline at end of file Copied: trunk/src/site/fr/resources/images/Hotel.objectmodel.png (from rev 694, trunk/eugene/src/site/resources/images/Hotel.objectmodel.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/Hotel.objectmodel.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/Hotel.png (from rev 694, trunk/eugene/src/site/resources/images/Hotel.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/Hotel.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/ObjectModel.png (from rev 694, trunk/eugene/src/site/resources/images/ObjectModel.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/ObjectModel.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/ObjectModel_Generator.png (from rev 694, trunk/eugene/src/site/resources/images/ObjectModel_Generator.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/ObjectModel_Generator.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/ObjectModel_Interfaces.png (from rev 694, trunk/eugene/src/site/resources/images/ObjectModel_Interfaces.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/ObjectModel_Interfaces.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/StateModel.png (from rev 694, trunk/eugene/src/site/resources/images/StateModel.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/StateModel.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/plugin_choix.png (from rev 694, trunk/eugene/src/site/resources/images/plugin_choix.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/plugin_choix.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/plugin_menu.png (from rev 694, trunk/eugene/src/site/resources/images/plugin_menu.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/plugin_menu.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/plugin_newdepot.png (from rev 694, trunk/eugene/src/site/resources/images/plugin_newdepot.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/plugin_newdepot.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/plugin_typeinstall.png (from rev 694, trunk/eugene/src/site/resources/images/plugin_typeinstall.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/plugin_typeinstall.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/images/plugin_utilisation_editeur.png (from rev 694, trunk/eugene/src/site/resources/images/plugin_utilisation_editeur.png) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/images/plugin_utilisation_editeur.png ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/resources/models/buix.guix (from rev 694, trunk/eugene/src/site/resources/models/buix.guix) =================================================================== --- trunk/src/site/fr/resources/models/buix.guix (rev 0) +++ trunk/src/site/fr/resources/models/buix.guix 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,409 @@ +<GuixApplication id="Application"> + <properties> + <property name="name" type="String"><value>Buix Application</value></property> + </properties> + <WidgetWindow id="GuixWindow"> + <properties> + <property name="name" type="String"><value>Buix</value></property> + <property name="title" type="String"><value>Application Buix</value></property> + <property name="x" type="int"><value>50</value></property> + <property name="y" type="int"><value>50</value></property> + <property name="width" type="int"><value>1000</value></property> + <property name="height" type="int"><value>800</value></property> + <property name="menubar" type="ComponentResource"><value>MenuBar</value></property> + </properties> + <signals> + <signal name="closing" argument="false" handler="onClosing"/> + </signals> + <children> + <child> + <WidgetContainer id="GuixGridBag"> + <properties> + <property name="name" type="String"><value>vbox</value></property> + </properties> + <children> + <child> + <layout> + <property name="x" type="int"><value>0</value></property> + <property name="y" type="int"><value>1</value></property> + <property name="weightx" type="double"><value>1.0</value></property> + <property name="weighty" type="double"><value>1.0</value></property> + </layout> + <WidgetContainer id="GuixSpliter"> + <properties> + <property name="name" type="String"><value>verticalSpliter</value></property> + <property name="orientation" type="Enum"><value><enum type="int" select="0"><item>0</item><item>1</item></enum></value></property> + <property name="dividerSize" type="int"><value>9</value></property> + <property name="express" type="boolean"><value>true</value></property> + </properties> + <children> + <child> + <layout> + <property name="position" type="Enum"><value><enum type="String" select="3"><item>left</item><item>right</item><item>bottom</item><item>top</item></enum></value></property> + </layout> + <WidgetContainer id="GuixScrollPane"> + <properties> + <property name="name" type="String"><value>scrollTree</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixTree"> + <properties> + <property name="name" type="String"><value>tree</value></property> + </properties> + <signals> + <signal name="clicked" argument="false" handler="onTreeClicked"/> + </signals> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="position" type="Enum"><value><enum type="String" select="2"><item>left</item><item>right</item><item>bottom</item><item>top</item></enum></value></property> + </layout> + <WidgetContainer id="GuixSpliter"> + <properties> + <property name="name" type="String"><value>horizontalSpliter</value></property> + <property name="orientation" type="Enum"><value><enum type="int" select="1"><item>0</item><item>1</item></enum></value></property> + <property name="dividerSize" type="int"><value>9</value></property> + <property name="express" type="boolean"><value>true</value></property> + </properties> + <children> + <child> + <layout> + <property name="position" type="Enum"><value><enum type="String" select="1"><item>left</item><item>right</item><item>bottom</item><item>top</item></enum></value></property> + </layout> + <WidgetContainer id="GuixTabbedPane"> + <properties> + <property name="name" type="String"><value>tabProperties</value></property> + <property name="childCount" type="int"><value>3</value></property> + </properties> + <children> + <child> + <layout> + <property name="text" type="String"><value>Properties</value></property> + <property name="position" type="int"><value>0</value></property> + </layout> + <WidgetContainer id="GuixScrollPane"> + <properties> + <property name="name" type="String"><value>scrollProperties</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixTable"> + <properties> + <property name="name" type="String"><value>tableProperties</value></property> + </properties> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="position" type="int"><value>1</value></property> + <property name="text" type="String"><value>Container Properties</value></property> + </layout> + <WidgetContainer id="GuixScrollPane"> + <properties> + <property name="name" type="String"><value>scrollContainerProperties</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixTable"> + <properties> + <property name="name" type="String"><value>tableContainerProperties</value></property> + </properties> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="text" type="String"><value>Signals</value></property> + <property name="position" type="int"><value>2</value></property> + </layout> + <WidgetContainer id="GuixGridBag"> + <properties> + <property name="name" type="String"><value>gridSignals</value></property> + </properties> + <children> + <child> + <layout> + <property name="weighty" type="double"><value>0.0</value></property> + </layout> + <WidgetComponent id="GuixComboBox"> + <properties> + <property name="name" type="String"><value>comboAllSignals</value></property> + </properties> + </WidgetComponent> + </child> + <child> + <layout> + <property name="weightx" type="double"><value>0.0</value></property> + <property name="weighty" type="double"><value>0.0</value></property> + <property name="x" type="int"><value>1</value></property> + </layout> + <WidgetComponent id="GuixButton"> + <properties> + <property name="name" type="String"><value>addSignal</value></property> + <property name="text" type="String"><value>add</value></property> + </properties> + <signals> + <signal name="clicked" argument="false" handler="onAddSignal"/> + </signals> + </WidgetComponent> + </child> + <child> + <layout> + <property name="x" type="int"><value>0</value></property> + <property name="y" type="int"><value>1</value></property> + <property name="width" type="int"><value>2</value></property> + </layout> + <WidgetContainer id="GuixScrollPane"> + <properties> + <property name="name" type="String"><value>scrollSignals</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixTable"> + <properties> + <property name="name" type="String"><value>tableSignals</value></property> + </properties> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="position" type="Enum"><value><enum type="String" select="0"><item>left</item><item>right</item><item>bottom</item><item>top</item></enum></value></property> + </layout> + <WidgetContainer id="GuixGridBag"> + <properties> + <property name="name" type="String"><value>GuixGridBag1</value></property> + </properties> + <children> + <child> + <layout> + <property name="weightx" type="double"><value>0.0</value></property> + <property name="weighty" type="double"><value>0.0</value></property> + </layout> + <WidgetComponent id="GuixButton"> + <properties> + <property name="name" type="String"><value>GuixButton16</value></property> + <property name="text" type="String"><value>Selection</value></property> + </properties> + <signals> + <signal name="clicked" argument="false" handler="onSelectionButton"/> + </signals> + </WidgetComponent> + </child> + <child> + <layout> + <property name="y" type="int"><value>1</value></property> + <property name="width" type="int"><value>2</value></property> + </layout> + <WidgetContainer id="GuixTabbedPane"> + <properties> + <property name="name" type="String"><value>tabTools</value></property> + <property name="childCount" type="int"><value>4</value></property> + </properties> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="weighty" type="double"><value>0.0</value></property> + </layout> + <WidgetContainer id="GuixGrid"> + <properties> + <property name="name" type="String"><value>toolbar</value></property> + </properties> + <children> + <child> + <layout> + <property name="x" type="int"><value>8</value></property> + </layout> + <WidgetComponent id="GuixCheckBox"> + <properties> + <property name="name" type="String"><value>checkboxDesignTime</value></property> + <property name="text" type="String"><value>Design</value></property> + <property name="selected" type="boolean"><value>true</value></property> + </properties> + <signals> + <signal name="itemStateChanged" argument="true" handler="onDesignTime"/> + </signals> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <layout> + <property name="y" type="int"><value>2</value></property> + <property name="weighty" type="double"><value>0.0</value></property> + </layout> + <WidgetComponent id="GuixLabel"> + <properties> + <property name="name" type="String"><value>statusBar</value></property> + <property name="text" type="String"><value> </value></property> + </properties> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetWindow> + <WidgetWindow id="GuixWindowNG"> + <properties> + <property name="name" type="String"><value>GuixWindowNG1</value></property> + </properties> + <children> + <child> + <WidgetContainer id="GuixMenuBar"> + <properties> + <property name="name" type="String"><value>MenuBar</value></property> + </properties> + <children> + <child> + <WidgetContainer id="GuixMenu"> + <properties> + <property name="name" type="String"><value>GuixMenu1</value></property> + <property name="text" type="String"><value>File</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem1</value></property> + <property name="text" type="String"><value>new</value></property> + <property name="icon" type="Resource"><value></value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onNew"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem2</value></property> + <property name="text" type="String"><value>load</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onLoad"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem3</value></property> + <property name="text" type="String"><value>save</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onSave"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem4</value></property> + <property name="text" type="String"><value>export</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onExport"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem8</value></property> + <property name="text" type="String"><value>preview</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onPreview"/> + </signals> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <WidgetContainer id="GuixMenu"> + <properties> + <property name="name" type="String"><value>GuixMenu2</value></property> + <property name="text" type="String"><value>Edit</value></property> + </properties> + <children> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem5</value></property> + <property name="text" type="String"><value>ajouter le composant</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onAddComponent"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem6</value></property> + <property name="text" type="String"><value>couper</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onCouper"/> + </signals> + </WidgetComponent> + </child> + <child> + <WidgetComponent id="GuixMenuItem"> + <properties> + <property name="name" type="String"><value>GuixMenuItem7</value></property> + <property name="text" type="String"><value>coller</value></property> + </properties> + <signals> + <signal name="menuClicked" argument="false" handler="onColler"/> + </signals> + </WidgetComponent> + </child> + </children> + </WidgetContainer> + </child> + <child> + <WidgetContainer id="GuixMenu"> + <properties> + <property name="name" type="String"><value>GuixMenu3</value></property> + <property name="text" type="String"><value>help</value></property> + </properties> + </WidgetContainer> + </child> + </children> + </WidgetContainer> + </child> + </children> + </WidgetWindow> +</GuixApplication> Copied: trunk/src/site/fr/resources/models/exemple.topiaModel (from rev 694, trunk/eugene/src/site/resources/models/exemple.topiaModel) =================================================================== --- trunk/src/site/fr/resources/models/exemple.topiaModel (rev 0) +++ trunk/src/site/fr/resources/models/exemple.topiaModel 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,48 @@ +<?xml version="1.0" encoding="ISO-8859-1"?> +<topiaModel xmlns:topia="http://www.codelutin.org/topia/topiaModel"> + <class name="Person" stereotype="entity" package="org.codelutin.test"> + <attribute multiplicity="1" name="name" visibility="public" type="java.lang.String"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + <attribute multiplicity="1" name="address" visibility="public" type="org.codelutin.test.Address"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + </class> + <class name="Employee" type="entity" extends="org.codelutin.test.Person" package="org.codelutin.test"> + <attribute multiplicity="1" name="address" visibility="public" type="org.codelutin.test.Company"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + </class> + <class name="Company" type="entity" package="org.codelutin.test"> + <attribute multiplicity="1" name="name" visibility="public" type="java.lang.String"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + <attribute multiplicity="1" name="address" visibility="public" type="org.codelutin.test.Address"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + <attribute multiplicity="n" name="address" visibility="public" type="org.codelutin.test.Employee"> + <tag name="mandatory" value="true"/> + <tag name="indexed" value="false"/> + <tag name="primaryKey" value="false"/> + <tag name="readonly" value="false"/> + </attribute> + <operation name="getTime" visibility="public" returnType="int"> + <parameter name="year" type="org.codelutin.Employee"/> + </operation> + </class> +</topiaModel> Copied: trunk/src/site/fr/resources/xmi/ObjectModel.zuml (from rev 694, trunk/eugene/src/site/resources/xmi/ObjectModel.zuml) =================================================================== (Binary files differ) Copied: trunk/src/site/fr/resources/xmi/objectmodel.zargo (from rev 694, trunk/eugene/src/site/resources/xmi/objectmodel.zargo) =================================================================== (Binary files differ) Property changes on: trunk/src/site/fr/resources/xmi/objectmodel.zargo ___________________________________________________________________ Added: svn:mime-type + application/octet-stream Added: svn:mergeinfo + Copied: trunk/src/site/fr/rst/DevUIDoc.rst (from rev 694, trunk/eugene/src/site/fr/rst/DevUIDoc.rst) =================================================================== --- trunk/src/site/fr/rst/DevUIDoc.rst (rev 0) +++ trunk/src/site/fr/rst/DevUIDoc.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,103 @@ +======= +UIModel +======= + +:Authors: Aurelie MAZELIER +:Revision: $Revision$ +:Date: $Date$ + + +.. contents:: + + +Model UIModel +============= + +En parcourant un fichier xml, il est possible de construire un objet +UIModel. Cet objet est défini par les interfaces suivantes. + + +Interfaces +---------- + +- UIModel : + + - version XML + - root de type UIModelObject + - le nom du package + - liste des objets du model + +- UIModelObject : + + - nom + - type + - un UIModelObject parent + - un UIModel + - une liste d'arguments + - une liste de propriétés + - une liste d'évènements + - une liste d'enfants + +- UIModelArgument : + + - une liste d'arguments + +- UIModelProperty : + + - un nom + - une valeur (de différents type : int, float ...) + - un index + +- UIModelEvent : + + - le nom de la addListenerMethod + - le nom de la listenerInterface + - le nom de la listenerMethod + - le nom du handler + - le nom de la eventProperty + +- UIModelChild : + + - un enfant UIModelObject + - la contrainte de l'enfant de type UIModelConstraint + +- UIModelConstraint : + + - une valeur de type Object ou String + + +Implantations +------------- + +Il existe deux implantations de ces interfaces. + + +impl +~~~~ + +Cette première implantation permet d'obtenir un UIModel lors +du parcours du fichier xml de type uimodel par le parser +XMLParser. + + +xml +~~~ + +Cette deuxième implantation permet d'obtenir un UIModel lors +du parcours du fichier xml de type javaxml par le parser +JavaXMLParser. + + +JavaXMLParser +------------- + +Ce parser permet de parcourir des fichiers javaxml afin d'obtenir un +objet UIModel. Ce parser utilise dom4j. + + +Générateurs +=========== + +- Génération d'objet UIModel (UIModelGenerator). Ce générateur utilise les classes précédentes afin d'obtenir un objet UIModel en fonction des fichiers xml. A partir de cet objet UIModel, il est possible de lancer la génération. Ces générateurs sont utilisées dans Topia pour générer les fichiers java à partir de l'objet UIModel. + +- Génération d'objet UIModel (UIModelGeneratorWithCapitalizeName). Ce générateur est une sous classe du premier. Il est possède une méthode permettant de mettre la première lettre en majuscule du nom d'un objet, d'une propriété... Copied: trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst (from rev 694, trunk/eugene/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst) =================================================================== --- trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst (rev 0) +++ trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,82 @@ +========================= +Principe de la génération +========================= + +Il y a deux façon de voir la génération. + +La première que l'on rencontre le plus +souvent génère des fichiers avec des sections à +modifier par le développeur. Ces sections sont marquées par des commentaires +que le générateur interprète pour savoir qu'il n'a pas le droit de modifier +cette partie de code. + +La deuxième qui à pour principe: + +- le générateur ne doit jamais modifier les fichiers de l'utilisateur. +- l'utilisateur ne doit jamais modifier le code généré + +De cette façon les choses sont clairement séparé, et cela est possible sans +utilisation d'artifice perturbant le développeur grâce au nouveau langage à +objet et à l'héritage. + +La grosse différence n'est pas dans les générateurs eux même mais dans les +templates de génération. Si tous les générateurs de la première catégorie +peuvent très bien servir pour faire de la génération de la seconde, +l'inverse n'est pas vrai. Car la seconde catégorie demande des générateurs +beaucoup plus simple, ce qui est d'ailleur un avantage pour la maintenance. + +Code Lutin utilise un générateur du deuxième type: Eugene + +Quelques générateurs de la première catégorie: + +- Acceleo (Obeo) +- Pragmatic (Argia) + +Les principes de Eugene +======================= + +- le générateur ne doit jamais modifier les fichiers de l'utilisateur. +- l'utilisateur ne doit jamais modifier le code généré +- le modèle est toujours la source (pas de reverse, pas de modification du + modèle par le générateur +- être le plus simple possible (simple à maintenir) +- s'appuyer sur les normes (XMI) +- pouvoir utiliser plusieurs fichiers XMI pour la même génération +- ne pas mettre dans le modèle des choses techniques (ex: type pour la base de + données) mais dans un fichier de propriété à coté du modèle. +- avoir une couche d'abstraction du XMI pour évité la modification des + templates si la version de XMI change (XMLObjectModel) +- s'appuyer sur un modèle mémoire simple (ObjectModel écrit spécifiquement + car aucun modèle simple n'a été trouvé) +- s'appuyer sur un langage puissant et connu des développeurs (Java) +- ne jamais mélanger le code généré et le code utilisateur +- pouvoir générer n'importe quelle type de fichier (XML, Java, texte, ...) +- être facilement intégrable dans une phase de génération/compilation + (task ant, plugin maven) +- être indépendant d'un outil de développement spécifique (chacun à le droit de + choisir l'éditeur qu'il souhaite). + +Défaut de la première solution +============================== + +- il faut prévoir partout ou l'utilisateur pourrait souhaiter ajouter du + code. Par exemple dans Pragmatic, on ne peut pas utiliser les imports car il + n'y a pas de section utilisateur à cet endroit, il faut donc à chaque fois + écrire le package lorsque l'on souhaite utiliser une classe non encore + importée. + +- le développeur voit beaucoup de code qu'il n'a pas le droit de modifier + ce qui complexifie la vue du développeur pour rien + +Défaut des générateurs le plus souvent rencontré +================================================ + +- Les générateurs au lieu d'utiliser un langage et façon de faire que tous + les développeurs connaissent réinvente leur propre syntaxe et langage. + +Eugene lui utilise seulement du Java et les tags JSP (<%, <%=, %>). +De cette façon le générateur reste simple pas de langage à développer et +parser. L'utilisateur qui connait Java connait le langage de template. Et +surtout l'utilisateur n'est pas limité par le langage développé +spécifiquement pour les templates. + Copied: trunk/src/site/fr/rst/FAQ.rst (from rev 694, trunk/eugene/src/site/fr/rst/FAQ.rst) =================================================================== --- trunk/src/site/fr/rst/FAQ.rst (rev 0) +++ trunk/src/site/fr/rst/FAQ.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,16 @@ +=== +FAQ +=== + +Comment convertir les modèles UML de Poseidon vers ArgoUML ? +============================================================ + +Il faut sauver le modèle sous Poseidon en XMI, on bien l'extraire du +fichier .zmul qui est en fait un fichier zip:: + + xlstproc -o <argo-file>.xmi poseidon2argouml.xsl <poseidon-file>.xmi + +Ensuite dans ArgoUML ouvrez le fichier généré. + +Les diagrammes ne sont pas convertie, il faut donc les recréer a partir des +classes en faisant du drag&drop. Copied: trunk/src/site/fr/rst/ObjectModel.rst (from rev 694, trunk/eugene/src/site/fr/rst/ObjectModel.rst) =================================================================== --- trunk/src/site/fr/rst/ObjectModel.rst (rev 0) +++ trunk/src/site/fr/rst/ObjectModel.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,92 @@ +=========== +ObjectModel +=========== + +:Authors: Arnaud Thimel, Florian Desbois +:Contact: eugene-devel@list.nuiton.org ou eugene-users@list.nuiton.org +:Revision: $Revision$ +:Date: $Date$ + + +.. contents:: + + +Introduction +============ + +Le générateur ObjectModelGenerator est prévu pour lire et analyser des modèles +objets puis générer du code à partir de ceux-ci. En UML, un modèle objet est +représenté par un diagramme de classe. Cette vision des modèles objet étant très +répandue, elle sert de base à l'ObjectModelGenerator (il est à noter cependant +que ce n'est pas obligatoire). + +Partons donc du principe que l'on dispose d'un modèle (diagramme de classe) créé +à l'aide d'un outil de modélisation au format XMI (XML Metadata Interchange). + +La génération de code se fait ensuite en trois étapes : + +- Epuration du XMI en un code XML ne conservant que les informations utiles ; +- Mise en mémoire du modèle simplifié ; +- Application des templates / génération de code. + + +Epuration du modèle XMI +======================= + +La plupart des outils de modélisation décrivent leur modèle en XMI. Or le XMI +est trop verbeux pour être compréhensible aisement. + +Eugene propose une tranformation XSLT permettant ainsi d'obtenir un XML +épuré décrivant le modèle et ne conservant que l'essentiel des informations. + +Parmi les informations extraites, on peut citer : + +- Objets (classes, classes abtraites, interfaces) +- Attributs (nom, type, visibilité, ...) +- Relations entre les classes (toutes multiplicités, navigabilité, classes d'association, ...) +- Opérations (nom, type de retour, noms et types des arguments, exceptions levées, ...) +- Stéréotypes + +A partir du diagramme suivant : + +.. image:: images/Hotel.png + +On obtient un ObjectModel tel que : + +.. image:: images/Hotel.objectmodel.png + + +Modèle mémoire +============== + +Une fois le XMI ramené à un XML compréhensible, le modèle est chargé en +mémoire afin de subir la génération. + +Ainsi, le modèle instancié est basé sur le diagramme de classes (méta-modèle) suivant : + +.. image:: images/ObjectModel.png + +Les interfaces disponibles pour les générateurs sont les suivantes : + +.. image:: images/ObjectModel_Interfaces.png + +ObjectModelGenerator : + +.. image:: images/ObjectModel_Generator.png + +Application des templates +========================= + +Chaque template est à lui seul un générateur qui hérite de ObjectModelGenerator. +Toute partie de ce générateur peut donc être surchargée permettant ainsi une +forte personnalisation des générateurs. Le rôle de l'ObjectModelGenerator est +donc de parcourir le modèle et à chaque élément clé du modèle, (model, classes +interfaces, classifier) les méthodes correspondantes sont appelées. Par défaut, +ces méthodes décrites dans le générateur de base sont vide, et il n'en ressort +donc aucun code généré. Les templates ont donc pour but de surcharger ses +méthodes et décrire le code qui va être généré. + +Les templates peuvent être de toutes sortes car ils peuvent générer un fichier +différent par modèle, par interface, par classe ou encore par classifier (souche +commune aux classes et interfaces). De plus, ils peuvent indifféremment générer +du code Java / XML ou encore tout autre type de code (texte ou autre...). Copied: trunk/src/site/fr/rst/Todo.rst (from rev 694, trunk/eugene/src/site/fr/rst/Todo.rst) =================================================================== --- trunk/src/site/fr/rst/Todo.rst (rev 0) +++ trunk/src/site/fr/rst/Todo.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,115 @@ +==== +TODO +==== + + +:Revision: $Revision$ +:Date: $Date$ + + +Idées ou choses à faire +======================= + +- support des InnerClasses (en xmi argo: la classe est declarer dans une classe + dans un element UML:Namespace.ownedElement) (`Evolution #59`_ ) + +- support des static (tout element declarer dans une class/interface: methode, + attribut, enumeration, class, ...) + (en xmi argo: ownerScope='classifier' ou ownerScope='instance') (`Evolution #58`_ ) + +.. _Evolution #59: http://www.nuiton.org/issues/show/59 +.. _Evolution #58: http://www.nuiton.org/issues/show/58 + +- peut-etre faire des tests unitaires avec http://juxy.tigris.org/ pour le xls + +- Permettre de faire du 'model to model' avant la generation + +Model to Model +============== + +(2009-10-19 : En cours de developpement : `branches/1.0.1-javabuilder`_ ) + +.. _branches/1.0.1-javabuilder: http://nuiton.org/repositories/browse/eugene/branches/1.0.1-Javabuilder + +Pour tout ce qui est génération de classe Java, le principe de base d'Eugene +est de dire que le développeur écrit directement ce qu'il souhaite voir dans +le fichier final. + +Cela pose quelques difficultés: + +- difficulté de prévoir les imports +- difficulté d'éviter la génération de deux méthodes ayant le même nom + +L'idée serait alors de constuire la classe Java souhaitée au final en appelant +des méthodes (addImport, addMethod, addAttribute, ...). Ceci nous donnerait +alors un nouveau modèle mémoire dont on demanderait la génération à un +générateur sans inteligence qui se contenterait d'écrire le code Java modélisé. + +L'avantage est que pour chaque méthode à ajouter on peut demander avant si elle +n'a pas déjà été ajoutée et ainsi potentiellement la renomé avant de l'inclure. +D'ajouter de façon automatique tous les imports des arguments des méthodes, ... + +Pour pouvoir faire cela, nous pourrions nous baser sur ObjectModel, mais des +ajouter doivent être fait: + +- pouvoir indiquer sur une Class une série d'import. +- pouvoir ajouter un message de licence +- pouvoir ajouter sur une méthode sont code source + +Ce dernier élément est le plus problèmatique, car il deviendrait pénible de +devoir instancier tout le code de la méthode en objet et on perdrait l'idée +de départ d'Eugene. + +Dans eugène il est déjà possible de modifier la transformation des tags de +génération '/\*{' et '}\*/' qui par défaut génère un 'ouput.write("...");' +Dans notre cas, il faudrait quelque chose comme 'method.addCode("...");' ou +encore plus simplement '"..." +' ce qui pourrait donner:: + + addImport(MonObject.class); + method.addCode( + /*{ int i = 0; + i = 1+2; + MonObject result = new MonObject(result); + return result; + }*/ + ); + +qui deviendrait:: + + addImport(MonObject.class); + method.addCode( + "int i = 0;\n" + + "i = 1+2;\n" + + "MonObject result = new MonObject(result);\n" + + "return result;\n" + ); + +On garde la facilte d'écriture du code à générer et on permet d'ajouter +facilement des imports dont on aurait besoin dans le coprs de la méthode. Aucun +traitement complexe du code de la méthode n'est donc nécessaire. + +Ce nouveau mode de génération ne serait qu'une moyen complémentaire de la +génération actuelle. + +Travail a faire: + +- ajout d'objet dans ObjectModel +- ajout de méthode de modification dans ObjectModel +- création d'un template de génération d'un POJO (génération direct d'un modèle) + +Il serait toute fois dommage d'ajouter tout un ensemnble de setter sur les +interfaces d'ObjectModel qui le rendrait moins clair pour les générateurs. +Il faut donc trouver une solution pour permettre l'instanciation et la +modification de classe implantant l'ObjectModel sans pour autant les ajouter +au interface. + +Une idée pourrait-être l'utilisation de Helper qui permette de créer et modifier +le modèle:: + + ObjectModelClass clazz = ObjectModelHelper.createClass(); + ObjectModelOperation method = ObjectModelHelper.addMethod( + clazz, "name", "typeRetour", "paramName", "typeParam"); + ObjectModelHelper.addImport("java.util.List"); + ObjectModelHelper.addCode(method, + /*{ blablabla + }*/ Added: trunk/src/site/fr/rst/index.rst =================================================================== --- trunk/src/site/fr/rst/index.rst (rev 0) +++ trunk/src/site/fr/rst/index.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,80 @@ +====== +Eugene +====== + +.. contents:: + + +Origine du projet +----------------- + +Eugene est né à la suite d'une recherche de générateur de code basé sur +un modèle mémoire simple qui s'est terminée par un échec. + +Les projets alors étudiés étaient alors entre autres : + +- Jostraca ; +- EMF ; +- ... + +Le choix de la génération de code par rapport à l'introspection a été fait car +la génération code permet de passer par l'étape compilation et donc de +validation du code généré. En effet, si le besoin était initialement porté sur +de la génération de code Java, Eugene a été pensé pour générer tout type +de code. + + +Côté technique +-------------- + +Eugene permet l'utilisation d'un ensemble de générateurs. Ces +générateurs sont abstraits de toute spécificité permettant ainsi de les adapter +en fonction des besoins. + +Par défaut, Eugene propose trois implantations de ces générateurs : + +- ObjectModelGenerator (génération à partir d'un modèle objet) ; +- StateModelGenerator (génération à partir d'un modèle d'états) ; +- UIModelGenerator (génération à partir d'un modèle graphique). + +Chacun de ces modèles a ses propres spécificités liés à sa structure et son mode +de fonctionnement... + +Cependant, ces générateurs sont inutiles sans des templates de génération. Les +templates sont les fichiers qui vont permettre de déterminer quel sera le +contenu généré en fonction du modèle initial. Grâce à NuitonProcessor_, ces +templates sont écrit avec une sytaxe proche de la syntaxe JSP en imbriquant les +portions de code Java avec les portions de code généré. Le rôle de +NuitonProcessor_ est de transformer ces templates en remplaçant la syntaxe JSP par +la syntaxe Java correpondante. Les classes Java obtenues peuvent donc être +compilées et deviennent autonomes. + +.. _NuitonProcessor: http://maven-site.nuiton.org/processor/ + +Règle ant +--------- + +Voici un exemple d'utilisation de la règle ant. + +:: + + <taskdef name="generator" classname="org.nuiton.eugene.GeneratorTask" + classpath="${compile.classpath}:${targetbuild}:${resources}" /> + + <target name="generate" description="generate"> + <generator srcdir="${modelDir}" destdir="${targetgen}" + resolver="org.nuiton.exemple.ResourceResolver" + templates="org.nuiton.example.JavaBeanGenerator" + properties="defaultPackage=org.nuiton,fullPackagePath=org.nuiton,extraPackages=org.nuiton" + classpath="${compile.classpath}:${targetbuild}:${resources}" /> + </target> + +Dans cette exemple, un template de génération sera apliqué sur tous les +fichiers. + +Plugin maven +------------ + +Un plugin maven est disponnible à l'adresse suivante +http://maven-site.nuiton.org/eugene/maven-eugene-plugin . Il permet l'utilisation +depuis maven de Eugene. Copied: trunk/src/site/fr/rst/maven-plugin.rst (from rev 694, trunk/maven-eugene-plugin/src/site/rst/index.rst) =================================================================== (Binary files differ) Copied: trunk/src/site/fr/rst/plugineclipse.rst (from rev 694, trunk/eugene/src/site/fr/rst/plugineclipse.rst) =================================================================== --- trunk/src/site/fr/rst/plugineclipse.rst (rev 0) +++ trunk/src/site/fr/rst/plugineclipse.rst 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,44 @@ +Installation du plugin LutinGenerator +===================================== + +Ce guide détail comment installer le plugin eclipse LutinGenerator via +l'update site (assitant d'instalation de plugins). + +Installation +------------ + +Ouvrez l'assitant d'installation de plugin via le menu +(Help/Software Updates/Find and install...). + +.. image:: images/plugin_menu.png + +Sur la fenêtre suivante sélectionnez "Search for new features to install". + +.. image:: images/plugin_typeinstall.png + +Une nouvelle fenêtre s'affiche, sélectionnez "New remote site" pour ajouter le +dépot "LutinGenerator". + +L'adresse du dépot à utiliser est : + +:: + + http://lutingenerator.labs.libre-entreprise.org/eclipse/ + +.. image:: images/plugin_newdepot.png + + +Sélectionnez ensuite ce dépot et cliquez sur "Finish". + +Installez ensuite la dernière version disponible et redémarrez eclipse: + +.. image:: images/plugin_choix.png + + +Utilisation +----------- + +Pour disposer de la coloration des templates, cliquez droit sur un fichier +source java et sélectionnez "Open with > / LutinGenerator Template Editor" + +.. image:: images/plugin_utilisation_editeur.png \ No newline at end of file Deleted: trunk/src/site/site.xml =================================================================== --- trunk/src/site/site.xml 2009-11-24 17:06:01 UTC (rev 718) +++ trunk/src/site/site.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -1,25 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - <href>/</href> - </bannerLeft> - - <poweredBy> - <logo href="http://maven.apache.org" name="Maven" img="${project.url}/images/logos/maven-feather.png"/> - <logo href="http://jrst.labs.libre-entreprise.org" name="JRst" img="${project.url}/images/jrst-logo.png"/> - <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="${project.url}/images/restructuredtext-logo.png"/> - </poweredBy> - - <body> - - <breadcrumbs> - <item name="${project.name}" href="${project.url}" /> - </breadcrumbs> - - <menu ref="modules"/> - - <menu ref="reports"/> - </body> -</project> Copied: trunk/src/site/site_en.xml (from rev 694, trunk/eugene/src/site/site_en.xml) =================================================================== --- trunk/src/site/site_en.xml (rev 0) +++ trunk/src/site/site_en.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,45 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="${project.name}"> + + <bannerLeft> + <name>${project.name}</name> + </bannerLeft> + + <poweredBy> + <logo href="http://maven-site.nuiton.org/jrst" name="JRst" img="http://maven-site.nuiton.org/jrst/images/jrst-logo.png"/> + <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="http://maven-site.nuiton.org/jrst/images/restructuredtext-logo.png"/> + </poweredBy> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="${project.url}" /> + </breadcrumbs> + + <links> + <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/" /> + </links> + + <menu name="User"> + <item href="index.html" name="Home"/> + <item href="../maven-eugene-plugin/en/plugin-info.html" name="Maven plugin" /> + </menu> + + <menu name="Links"> + <item href="../fr/index.html" name="EUGene project [ FR ]" /> + <item name="Downloads" href="http://${platform}/projects/list_files/eugene" /> + <item href="../eugene/en/index.html" name="EUGene Module" title="Access to reports and javadoc for EUGene module" /> + <item name="Nuiton-processor" href="http://nuiton.org/projects/show/processor"/> + <item name="ToPIA" href="http://nuiton.org/projects/show/topia"/> + </menu> + + <menu name="Trackers"> + <item name="Bugs" href="${project.issueManagement.url}?query_id=2"/> + <item name="Evolutions" href="${project.issueManagement.url}?query_id=1"/> + <item name="Help" href="${project.issueManagement.url}?query_id=3"/> + </menu> + + <menu ref="reports"/> + + </body> +</project> Property changes on: trunk/src/site/site_en.xml ___________________________________________________________________ Added: svn:mergeinfo + Copied: trunk/src/site/site_fr.xml (from rev 694, trunk/eugene/src/site/site_fr.xml) =================================================================== --- trunk/src/site/site_fr.xml (rev 0) +++ trunk/src/site/site_fr.xml 2009-11-24 17:06:20 UTC (rev 719) @@ -0,0 +1,56 @@ +<?xml version="1.0" encoding="UTF-8"?> +<project name="${project.name}"> + + <bannerLeft> + <name>${project.name}</name> + </bannerLeft> + + <poweredBy> + <logo href="http://maven-site.nuiton.org/jrst" name="JRst" img="http://maven-site.nuiton.org/jrst/images/jrst-logo.png"/> + <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="http://maven-site.nuiton.org/jrst/images/restructuredtext-logo.png"/> + </poweredBy> + + <body> + + <breadcrumbs> + <item name="${project.name}" href="index.html" /> + </breadcrumbs> + + <links> + <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/" /> + </links> + + <menu name="Utilisateur"> + <item href="index.html" name="Accueil"/> + <item href="DiscussionSurTypeDeGeneration.html" name="Génération"/> + <item href="../maven-eugene-plugin/fr/plugin-info.html" name="Plugin maven" /> + <item href="FAQ.html" name="FAQ"/> + </menu> + + <menu name="Développeur"> + <item name="ObjectModel" href="ObjectModel.html"/> + <item name="UIModel" href="DevUIDoc.html"/> + <item name="Plugin Eclipse" href="plugineclipse.html"/> + <item name="Todo" href="Todo.html"/> + </menu> + + <menu name="Liens"> + <item href="../en/index.html" name="EUGene project [ EN ]" /> + <item href="http://${platform}/projects/list_files/eugene" name="Téléchargement" /> + <item href="../eugene/fr/index.html" name="Module EUGene" title="Accès aux rapports et javadoc du module EUGene"/> + <item href="http://nuiton.org/projects/show/processor" name="Nuiton-processor"/> + <item href="http://nuiton.org/projects/show/topia" name="ToPIA"/> + </menu> + + <menu name="Trackers"> + <item name="Bugs" href="${project.issueManagement.url}?query_id=2"/> + <item name="Améliorations" href="${project.issueManagement.url}?query_id=1"/> + <item name="Aide" href="${project.issueManagement.url}?query_id=3"/> + </menu> + + <menu ref="modules"/> + + <menu ref="reports"/> + + </body> +</project> Property changes on: trunk/src/site/site_fr.xml ___________________________________________________________________ Added: svn:mergeinfo +