Author: fdesbois Date: 2009-11-25 12:37:26 +0100 (Wed, 25 Nov 2009) New Revision: 722 Added: trunk/eugene/src/site/rst/ trunk/eugene/src/site/rst/index.rst trunk/eugene/src/site/site.xml trunk/maven-eugene-plugin/src/site/site.xml trunk/src/site/resources/ trunk/src/site/resources/images/ trunk/src/site/resources/images/Hotel.objectmodel.png trunk/src/site/resources/images/Hotel.png trunk/src/site/resources/images/ObjectModel.png trunk/src/site/resources/images/ObjectModel_Generator.png trunk/src/site/resources/images/ObjectModel_Interfaces.png trunk/src/site/resources/images/StateModel.png trunk/src/site/resources/images/plugin_choix.png trunk/src/site/resources/images/plugin_menu.png trunk/src/site/resources/images/plugin_newdepot.png trunk/src/site/resources/images/plugin_typeinstall.png trunk/src/site/resources/images/plugin_utilisation_editeur.png trunk/src/site/resources/models/ trunk/src/site/resources/models/buix.guix trunk/src/site/resources/models/exemple.topiaModel trunk/src/site/resources/xmi/ trunk/src/site/resources/xmi/ObjectModel.zuml trunk/src/site/resources/xmi/objectmodel.zargo trunk/src/site/rst/ trunk/src/site/rst/DevUIDoc.rst trunk/src/site/rst/DiscussionSurTypeDeGeneration.rst trunk/src/site/rst/FAQ.rst trunk/src/site/rst/ObjectModel.rst trunk/src/site/rst/Todo.rst trunk/src/site/rst/index.rst trunk/src/site/rst/maven-plugin.rst trunk/src/site/rst/plugineclipse.rst trunk/src/site/site.xml Removed: trunk/eugene/src/site/fr/rst/index.rst trunk/eugene/src/site/site_fr.xml trunk/maven-eugene-plugin/src/site/site_fr.xml 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/buix.guix trunk/src/site/fr/resources/models/exemple.topiaModel trunk/src/site/fr/resources/xmi/ObjectModel.zuml trunk/src/site/fr/resources/xmi/objectmodel.zargo 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_fr.xml Modified: trunk/eugene/src/site/site_en.xml trunk/maven-eugene-plugin/src/site/site_en.xml trunk/pom.xml trunk/src/site/site_en.xml Log: Change site hierarchy Deleted: trunk/eugene/src/site/fr/rst/index.rst =================================================================== --- trunk/eugene/src/site/fr/rst/index.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/eugene/src/site/fr/rst/index.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -1,7 +0,0 @@ -====== -Eugene -====== - -Voir details sur le site `parent`_ - -.. _parent: ../../fr/index.html Copied: trunk/eugene/src/site/rst/index.rst (from rev 719, trunk/eugene/src/site/fr/rst/index.rst) =================================================================== --- trunk/eugene/src/site/rst/index.rst (rev 0) +++ trunk/eugene/src/site/rst/index.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -0,0 +1,7 @@ +====== +Eugene +====== + +Voir details sur le site `parent`_ + +.. _parent: ../index.html Copied: trunk/eugene/src/site/site.xml (from rev 719, trunk/eugene/src/site/site_fr.xml) =================================================================== --- trunk/eugene/src/site/site.xml (rev 0) +++ trunk/eugene/src/site/site.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -0,0 +1,19 @@ +<?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="parent"/> + + <menu ref="reports"/> + + </body> +</project> Property changes on: trunk/eugene/src/site/site.xml ___________________________________________________________________ Added: svn:mergeinfo + Modified: trunk/eugene/src/site/site_en.xml =================================================================== --- trunk/eugene/src/site/site_en.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/eugene/src/site/site_en.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -10,6 +10,10 @@ <breadcrumbs> <item name="${project.name}" href="index.html" /> </breadcrumbs> + + <menu name="Parent"> + <item href="../../index.html" name="${project.parent.name}"/> + </menu> <menu ref="reports"/> Deleted: trunk/eugene/src/site/site_fr.xml =================================================================== --- trunk/eugene/src/site/site_fr.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/eugene/src/site/site_fr.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -1,17 +0,0 @@ -<?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.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site.xml (rev 0) +++ trunk/maven-eugene-plugin/src/site/site.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -0,0 +1,19 @@ +<?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="parent"/> + + <menu ref="reports"/> + + </body> +</project> Modified: trunk/maven-eugene-plugin/src/site/site_en.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site_en.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/maven-eugene-plugin/src/site/site_en.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -11,6 +11,10 @@ <item name="${project.name}" href="index.html" /> </breadcrumbs> + <menu name="Parent"> + <item href="../../index.html" name="${project.parent.name}"/> + </menu> + <menu ref="reports"/> </body> Deleted: trunk/maven-eugene-plugin/src/site/site_fr.xml =================================================================== --- trunk/maven-eugene-plugin/src/site/site_fr.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/maven-eugene-plugin/src/site/site_fr.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -1,17 +0,0 @@ -<?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-25 11:36:25 UTC (rev 721) +++ trunk/pom.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -246,29 +246,12 @@ <!--Multilanguage maven-site --> <maven.site.locales>fr,en</maven.site.locales> - + <defaultLocale>fr</defaultLocale> </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> Deleted: trunk/src/site/fr/resources/images/Hotel.objectmodel.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/Hotel.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/ObjectModel.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/ObjectModel_Generator.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/ObjectModel_Interfaces.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/StateModel.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/plugin_choix.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/plugin_menu.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/plugin_newdepot.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/plugin_typeinstall.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/images/plugin_utilisation_editeur.png =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/models/buix.guix =================================================================== --- trunk/src/site/fr/resources/models/buix.guix 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/resources/models/buix.guix 2009-11-25 11:37:26 UTC (rev 722) @@ -1,409 +0,0 @@ -<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> Deleted: trunk/src/site/fr/resources/models/exemple.topiaModel =================================================================== --- trunk/src/site/fr/resources/models/exemple.topiaModel 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/resources/models/exemple.topiaModel 2009-11-25 11:37:26 UTC (rev 722) @@ -1,48 +0,0 @@ -<?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> Deleted: trunk/src/site/fr/resources/xmi/ObjectModel.zuml =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/resources/xmi/objectmodel.zargo =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/rst/DevUIDoc.rst =================================================================== --- trunk/src/site/fr/rst/DevUIDoc.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/DevUIDoc.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst =================================================================== --- trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/src/site/fr/rst/FAQ.rst =================================================================== --- trunk/src/site/fr/rst/FAQ.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/FAQ.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/src/site/fr/rst/ObjectModel.rst =================================================================== --- trunk/src/site/fr/rst/ObjectModel.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/ObjectModel.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/src/site/fr/rst/Todo.rst =================================================================== --- trunk/src/site/fr/rst/Todo.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/Todo.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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 - }*/ Deleted: trunk/src/site/fr/rst/index.rst =================================================================== --- trunk/src/site/fr/rst/index.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/index.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -1,80 +0,0 @@ -====== -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. Deleted: trunk/src/site/fr/rst/maven-plugin.rst =================================================================== (Binary files differ) Deleted: trunk/src/site/fr/rst/plugineclipse.rst =================================================================== --- trunk/src/site/fr/rst/plugineclipse.rst 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/fr/rst/plugineclipse.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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 Copied: trunk/src/site/resources/images/Hotel.objectmodel.png (from rev 719, trunk/src/site/fr/resources/images/Hotel.objectmodel.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/Hotel.png (from rev 719, trunk/src/site/fr/resources/images/Hotel.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/ObjectModel.png (from rev 719, trunk/src/site/fr/resources/images/ObjectModel.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/ObjectModel_Generator.png (from rev 719, trunk/src/site/fr/resources/images/ObjectModel_Generator.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/ObjectModel_Interfaces.png (from rev 719, trunk/src/site/fr/resources/images/ObjectModel_Interfaces.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/StateModel.png (from rev 719, trunk/src/site/fr/resources/images/StateModel.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/plugin_choix.png (from rev 719, trunk/src/site/fr/resources/images/plugin_choix.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/plugin_menu.png (from rev 719, trunk/src/site/fr/resources/images/plugin_menu.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/plugin_newdepot.png (from rev 719, trunk/src/site/fr/resources/images/plugin_newdepot.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/plugin_typeinstall.png (from rev 719, trunk/src/site/fr/resources/images/plugin_typeinstall.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/images/plugin_utilisation_editeur.png (from rev 719, trunk/src/site/fr/resources/images/plugin_utilisation_editeur.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/models/buix.guix (from rev 719, trunk/src/site/fr/resources/models/buix.guix) =================================================================== --- trunk/src/site/resources/models/buix.guix (rev 0) +++ trunk/src/site/resources/models/buix.guix 2009-11-25 11:37:26 UTC (rev 722) @@ -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/resources/models/exemple.topiaModel (from rev 719, trunk/src/site/fr/resources/models/exemple.topiaModel) =================================================================== --- trunk/src/site/resources/models/exemple.topiaModel (rev 0) +++ trunk/src/site/resources/models/exemple.topiaModel 2009-11-25 11:37:26 UTC (rev 722) @@ -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/resources/xmi/ObjectModel.zuml (from rev 719, trunk/src/site/fr/resources/xmi/ObjectModel.zuml) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/xmi/objectmodel.zargo (from rev 719, trunk/src/site/fr/resources/xmi/objectmodel.zargo) =================================================================== (Binary files differ) Copied: trunk/src/site/rst/DevUIDoc.rst (from rev 719, trunk/src/site/fr/rst/DevUIDoc.rst) =================================================================== --- trunk/src/site/rst/DevUIDoc.rst (rev 0) +++ trunk/src/site/rst/DevUIDoc.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/rst/DiscussionSurTypeDeGeneration.rst (from rev 719, trunk/src/site/fr/rst/DiscussionSurTypeDeGeneration.rst) =================================================================== --- trunk/src/site/rst/DiscussionSurTypeDeGeneration.rst (rev 0) +++ trunk/src/site/rst/DiscussionSurTypeDeGeneration.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/rst/FAQ.rst (from rev 719, trunk/src/site/fr/rst/FAQ.rst) =================================================================== --- trunk/src/site/rst/FAQ.rst (rev 0) +++ trunk/src/site/rst/FAQ.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/rst/ObjectModel.rst (from rev 719, trunk/src/site/fr/rst/ObjectModel.rst) =================================================================== --- trunk/src/site/rst/ObjectModel.rst (rev 0) +++ trunk/src/site/rst/ObjectModel.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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/rst/Todo.rst (from rev 719, trunk/src/site/fr/rst/Todo.rst) =================================================================== --- trunk/src/site/rst/Todo.rst (rev 0) +++ trunk/src/site/rst/Todo.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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 + }*/ Copied: trunk/src/site/rst/index.rst (from rev 719, trunk/src/site/fr/rst/index.rst) =================================================================== --- trunk/src/site/rst/index.rst (rev 0) +++ trunk/src/site/rst/index.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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. Property changes on: trunk/src/site/rst/index.rst ___________________________________________________________________ Added: svn:mergeinfo + Copied: trunk/src/site/rst/maven-plugin.rst (from rev 719, trunk/src/site/fr/rst/maven-plugin.rst) =================================================================== (Binary files differ) Copied: trunk/src/site/rst/plugineclipse.rst (from rev 719, trunk/src/site/fr/rst/plugineclipse.rst) =================================================================== --- trunk/src/site/rst/plugineclipse.rst (rev 0) +++ trunk/src/site/rst/plugineclipse.rst 2009-11-25 11:37:26 UTC (rev 722) @@ -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 Added: trunk/src/site/site.xml =================================================================== --- trunk/src/site/site.xml (rev 0) +++ trunk/src/site/site.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -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.apache.org" name="Maven" img="${project.url}/images/logos/maven-feather.png"/> + <logo href="http://maven-site.nuiton.org/jrst" 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="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/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="http://maven-site.nuiton.org/processor" name="Nuiton-processor" /> + <item href="http://maven-site.nuiton.org/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> Modified: trunk/src/site/site_en.xml =================================================================== --- trunk/src/site/site_en.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/site_en.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -6,9 +6,9 @@ </bannerLeft> <poweredBy> - <logo href="http://maven.apache.org" name="Maven" img="../../jrst/images/logos/maven-feather.png"/> - <logo href="../../jrst" name="JRst" img="../../jrst/images/jrst-logo.png"/> - <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="../../jrst/images/restructuredtext-logo.png"/> + <logo href="http://maven.apache.org" name="Maven" img="${project.url}/jrst/images/logos/maven-feather.png"/> + <logo href="http://maven-site.nuiton.org/jrst" name="JRst" img="${project.url}/jrst/images/jrst-logo.png"/> + <logo href="http://docutils.sourceforge.net/rst.html" name="ReStructuredText" img="${project.url}/jrst/images/restructuredtext-logo.png"/> </poweredBy> <body> @@ -27,11 +27,10 @@ </menu> <menu name="Links"> - <item href="../fr/index.html" name="EUGene project [ FR ]" /> + <item href="../index.html" name="EUGene project [ FR ]" /> <item href="http://${platform}/projects/list_files/eugene" name="Downloads" /> - <item href="../eugene/en/index.html" name="EUGene Module" title="Access to reports and javadoc for EUGene module" /> - <item href="../../processor" name="Nuiton-processor" /> - <item href="../../topia" name="ToPIA" /> + <item href="http://maven-site.nuiton.org/processor" name="Nuiton-processor" /> + <item href="http://maven-site.nuiton.org/topia" name="ToPIA" /> </menu> <menu name="Trackers"> @@ -40,6 +39,11 @@ <item name="Help" href="${project.issueManagement.url}?query_id=3"/> </menu> + <menu name="Modules"> + <item href="../eugene/en/index.html" name="EUGene"/> + <item href="../maven-eugene-plugin/en/index.html" name="EUGene - plugin maven"/> + </menu> + <menu ref="reports"/> </body> Deleted: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2009-11-25 11:36:25 UTC (rev 721) +++ trunk/src/site/site_fr.xml 2009-11-25 11:37:26 UTC (rev 722) @@ -1,57 +0,0 @@ -<?xml version="1.0" encoding="UTF-8"?> -<project name="${project.name}"> - - <bannerLeft> - <name>${project.name}</name> - </bannerLeft> - - <poweredBy> - <logo href="http://maven.apache.org" name="Maven" img="${project.url}/images/logos/maven-feather.png"/> - <logo href="../../jrst" 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="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="../../processor" name="Nuiton-processor" /> - <item href="../../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>