Author: echatellier Date: 2011-03-03 16:19:13 +0100 (Thu, 03 Mar 2011) New Revision: 2215 Url: http://nuiton.org/repositories/revision/topia/2215 Log: Update howto, move it to "user" section Modified: trunk/topia-persistence/src/site/rst/howto.rst trunk/topia-persistence/src/site/site_fr.xml Modified: trunk/topia-persistence/src/site/rst/howto.rst =================================================================== --- trunk/topia-persistence/src/site/rst/howto.rst 2011-03-03 15:09:03 UTC (rev 2214) +++ trunk/topia-persistence/src/site/rst/howto.rst 2011-03-03 15:19:13 UTC (rev 2215) @@ -5,7 +5,7 @@ .. * $Id$ .. * $HeadURL$ .. * %% -.. * Copyright (C) 2004 - 2010 CodeLutin +.. * Copyright (C) 2004 - 2011 CodeLutin, Chatellier Eric .. * %% .. * This program is free software: you can redistribute it and/or modify .. * it under the terms of the GNU Lesser General Public License as @@ -57,7 +57,7 @@ # Précise l'entête de l'ensemble des fichiers générés # model.tagvalue.copyright=<valeur> - model.tagvalue.copyright=/* *##%\n Copyright (C) 2009 Code Lutin\n *##% */ + model.tagvalue.copyright=/* *##%\n Copyright (C) 2011 Code Lutin\n *##% */ # Force le chargement d'un attribut # <nom paquetage>.<nom entité>.attribute.<nom attribut>.tagvalue.lazy=false @@ -66,38 +66,32 @@ Génération ---------- -La génération des fichiers Topia se font par l'utilisation d'un plugin maven. -Le plugin est disponnible sur le repository maven de Code Lutin à l'adresse -suivante http://lutinbuilder.labs.libre-entreprise.org/maven2. +La génération des fichiers Topia se font par l'utilisation du plugin maven +Eugene_. Ce plugin est disponible sur le repository central. Configuration du plugin maven : :: <plugin> - <groupId>org.codelutin</groupId> - <artifactId>maven-generator-plugin</artifactId> - <version>0.64</version> + <groupId>org.nuiton.eugene</groupId> + <artifactId>maven-eugene-plugin</artifactId> + <version>2.3.2</version> <executions> <execution> <phase>process-sources</phase> <!--Configuration of model generator--> <configuration> - <addCompileDirectory>true</addCompileDirectory> - <srcDirZuml>${maven.src.dir}/main/xmi</srcDirZuml> - <srcXmiDest>${maven.gen.dir}/xmi/</srcXmiDest> - <srcGenDest>${maven.gen.dir}/objectmodel/</srcGenDest> - <includes>**/*.objectmodel</includes> - <templates>org.nuiton.topia.generator.TopiaMetaGenerator</templates> - <destDirGen>${maven.gen.dir}/java</destDirGen> - <defaultPackage>org.codelutin</defaultPackage> - <extractedPackages>org.codelutin</extractedPackages> - <fullPackagePath>org.codelutin</fullPackagePath> + <inputs>zargo</inputs> + <fullPackagePath>org.nuiton.topiatest</fullPackagePath> + <defaultPackage>org.nuiton.topiatest</defaultPackage> + <extractedPackages>org.nuiton.topiatest</extractedPackages> + <templates> + org.nuiton.topia.generator.TopiaMetaTransformer + </templates> </configuration> <goals> - <goal>zargo2xmi</goal> - <goal>xmi2objectmodel</goal> - <goal>generate</goal> + <goal>smart-generate</goal> </goals> </execution> </executions> @@ -105,17 +99,17 @@ <dependency> <groupId>org.nuiton.topia</groupId> <artifactId>topia-persistence</artifactId> - <version>2.1.3</version> + <version>2.5.2</version> <scope>compile</scope> </dependency> </dependencies> </plugin> -Le plugin utilise lutin generator avec les templates de génération de Topia, le +Le plugin utilise Eugene_ avec les templates de génération de Topia, le fichier argouml ou poséidon doit se trouver dans le répertoire -${maven.src.dir}/main/xmi. Les fichiers sont générés dans le répertoire -${maven.gen.dir}/java. Il faut préciser au plugin les paquetages à traiter avec -le defaultPackage et extractedPackages. +``src/main/xmi``. Les fichiers sont générés dans le répertoire +``target/generated-sources/java``. Il faut préciser au plugin les paquetages +à traiter avec le ``defaultPackage`` et ``extractedPackages``. Ajout dans des dépendances de Topia pour la compilation des fichiers générés : @@ -124,7 +118,7 @@ <dependency> <groupId>org.nuiton.topia</groupId> <artifactId>topia-persistence</artifactId> - <version>2.1.3</version> + <version>2.5.2</version> <scope>compile</scope> </dependency> @@ -143,6 +137,7 @@ Un fichier contenant les informations de connexion à la base de données et de configuration de Topia doit être créé au niveau des ressources du projet. +Par convention, ce fichier est nommé ``TopiaContextImpl.properties``. Exemple : @@ -282,3 +277,5 @@ transaction.closeContext(); rootContext.closeContext(); + +.. _Eugene: http://maven-site.nuiton.org/eugene/ Modified: trunk/topia-persistence/src/site/site_fr.xml =================================================================== --- trunk/topia-persistence/src/site/site_fr.xml 2011-03-03 15:09:03 UTC (rev 2214) +++ trunk/topia-persistence/src/site/site_fr.xml 2011-03-03 15:19:13 UTC (rev 2215) @@ -6,7 +6,7 @@ $Id$ $HeadURL$ %% - Copyright (C) 2004 - 2010 CodeLutin + Copyright (C) 2004 - 2011 CodeLutin, Chatellier Eric %% This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as @@ -39,8 +39,26 @@ <menu ref="parent"/> - <menu name="Utilisateur" inherit="top"/> + <menu name="Utilisateur" inherit="top"> + <menu name="Utilisation" href="howto.html" /> + <menu name="Tag values" href="tagvalues.html" /> + </menu> + <menu name="Developpeur"> + <item name="Todo" href="Todo.html"/> + <item name="Mapping hibernate" href="HibernateMapping.html"/> + <item name="Gestion des evenements" href="event.html"/> + <item name="Isolation" href="Isolation.html"/> + <item name="Schema migration" href="SchemaMigration.html"/> + <item name="Securité" href="security.html"/> + <item name="Génération des modèles" href="ModelGeneration.html"/> + <item name="TopiaContextFactory" href="Devel.html"/> + <item name="TopiaQuery" href="TopiaQuery.html"/> + <item name="FAQ" href="FAQ.html"/> + <item name="Projets similaires" href="project.html"/> + <item name="Tag values" href="tagvalues.html"/> + </menu> + <menu name="Téléchargement"> <item href="${repository.home.url}/org/nuiton/topia/${project.artifactId}/${project.version}/${project.build.finalName}.jar" name="Librairie (jar)"/> @@ -56,21 +74,6 @@ name="Test Sources (jar)"/> </menu> - <menu name="Developpeur"> - <item name="Todo" href="Todo.html"/> - <item name="Mapping hibernate" href="HibernateMapping.html"/> - <item name="Gestion des evenements" href="event.html"/> - <item name="Isolation" href="Isolation.html"/> - <item name="Schema migration" href="SchemaMigration.html"/> - <item name="Securité" href="security.html"/> - <item name="How-to" href="howto.html"/> - <item name="Génération des modèles" href="ModelGeneration.html"/> - <item name="TopiaContextFactory" href="Devel.html"/> - <item name="TopiaQuery" href="TopiaQuery.html"/> - <item name="FAQ" href="FAQ.html"/> - <item name="Projets similaires" href="project.html"/> - </menu> - <menu ref="reports"/> </body>