August 2012 - Topia-commits - mailman.cloud.codelutin.com

r2614 - branches/topia-2.6.x/topia-persistence/src/main/java/org/nuiton/topia/generator
by tchemit＠users.nuiton.org Aug. 14, 2012

Aug. 14, 2012

Author: tchemit Date: 2012-08-14 18:41:46 +0200 (Tue, 14 Aug 2012) New Revision: 2614 Url: http://nuiton.org/repositories/revision/topia/2614 Log: fixes #2257: not null are not generated in XXXEntityEnum is not in naturalId Modified: branches/topia-2.6.x/topia-persistence/src/main/java/org/nuiton/topia/generator/DAOHelperTransformer.java Modified: branches/topia-2.6.x/topia-persistence/src/main/java/org/nuiton/topia/generator/DAOHelperTransformer.java =================================================================== --- branches/topia-2.6.x/topia-persistence/src/main/java/org/nuiton/topia/generator/DAOHelperTransformer.java 2012-08-14 16:03:27 UTC (rev 2613) +++ branches/topia-2.6.x/topia-persistence/src/main/java/org/nuiton/topia/generator/DAOHelperTransformer.java 2012-08-14 16:41:46 UTC (rev 2614) @@ -324,16 +324,17 @@ StringBuilder notNullParams = new StringBuilder(); Set<ObjectModelAttribute> naturalIdsAttributes = TopiaGeneratorUtil.getNaturalIdAttributes(clazz); - for (ObjectModelAttribute naturalIdAttributes : naturalIdsAttributes) { + for (ObjectModelAttribute attribute: naturalIdsAttributes) { withNatural = true; // attribut metier - naturalIdsParams.append(", \"").append(naturalIdAttributes.getName()).append("\""); - if (TopiaGeneratorUtil.isNotNull(naturalIdAttributes)) { - withNotNull = true; - // attribut not-null - notNullParams.append(", \"").append(naturalIdAttributes.getName()).append("\""); - } + naturalIdsParams.append(", \"").append(attribute.getName()).append("\""); } + Set<ObjectModelAttribute> notNullIdsAttributes = TopiaGeneratorUtil.getNotNullAttributes(clazz); + for (ObjectModelAttribute attribute : notNullIdsAttributes) { + withNotNull = true; + // attribut not-null + notNullParams.append(", \"").append(attribute.getName()).append("\""); + } StringBuilder params = new StringBuilder(clazzName + ".class"); if (withNotNull) {

1 0

r2613 - branches/topia-2.6.x/topia-service-security
by tchemit＠users.nuiton.org Aug. 14, 2012

Aug. 14, 2012

Author: tchemit Date: 2012-08-14 18:03:27 +0200 (Tue, 14 Aug 2012) New Revision: 2613 Url: http://nuiton.org/repositories/revision/topia/2613 Log: fix release build (usage of some sun.xxx classes) Modified: branches/topia-2.6.x/topia-service-security/pom.xml Modified: branches/topia-2.6.x/topia-service-security/pom.xml =================================================================== --- branches/topia-2.6.x/topia-service-security/pom.xml 2012-08-14 15:57:26 UTC (rev 2612) +++ branches/topia-2.6.x/topia-service-security/pom.xml 2012-08-14 16:03:27 UTC (rev 2613) @@ -132,6 +132,23 @@ </resources> + <pluginManagement> +  + <plugins> + <plugin> + <groupId>org.codehaus.mojo</groupId> + <artifactId>animal-sniffer-maven-plugin</artifactId> + <configuration> + <signature> + <groupId>org.codehaus.mojo.signature</groupId> + <artifactId>java16-sun</artifactId> + <version>1.10</version> + </signature> + </configuration> + </plugin> + </plugins> + </pluginManagement> + <plugins> <plugin>

1 0

r2612 - branches/topia-2.6.x/topia-persistence
by tchemit＠users.nuiton.org Aug. 14, 2012

Aug. 14, 2012

Author: tchemit Date: 2012-08-14 17:57:26 +0200 (Tue, 14 Aug 2012) New Revision: 2612 Url: http://nuiton.org/repositories/revision/topia/2612 Log: refs #2256: updates to eugene 2.5 Modified: branches/topia-2.6.x/topia-persistence/pom.xml Modified: branches/topia-2.6.x/topia-persistence/pom.xml =================================================================== --- branches/topia-2.6.x/topia-persistence/pom.xml 2012-08-14 15:48:02 UTC (rev 2611) +++ branches/topia-2.6.x/topia-persistence/pom.xml 2012-08-14 15:57:26 UTC (rev 2612) @@ -236,7 +236,7 @@ <defaultPackage>org.nuiton.topia</defaultPackage> </configuration> <goals> - <goal>smart-generate</goal> + <goal>generate</goal> </goals> </execution> </executions>

1 0

r2611 - in branches/topia-2.6.x: . topia-persistence topia-persistence/src/it/ANOMALIE-1640 topia-persistence/src/site/rst/user topia-service-security
by tchemit＠users.nuiton.org Aug. 14, 2012

Aug. 14, 2012

Author: tchemit Date: 2012-08-14 17:48:02 +0200 (Tue, 14 Aug 2012) New Revision: 2611 Url: http://nuiton.org/repositories/revision/topia/2611 Log: fixes #2256: updates to eugene 2.5 fixes #2255: updates to mavenpom 3.3.6 fix some docs (use velicoty extension to have maven model properties in generated docs) Added: branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst.vm branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst.vm Removed: branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst Modified: branches/topia-2.6.x/pom.xml branches/topia-2.6.x/topia-persistence/pom.xml branches/topia-2.6.x/topia-persistence/src/it/ANOMALIE-1640/pom.xml branches/topia-2.6.x/topia-service-security/pom.xml Modified: branches/topia-2.6.x/pom.xml =================================================================== --- branches/topia-2.6.x/pom.xml 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/pom.xml 2012-08-14 15:48:02 UTC (rev 2611) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmineAndCentral</artifactId> - <version>3.3.5</version> + <version>3.3.6</version> </parent> <artifactId>topia</artifactId> @@ -67,14 +67,14 @@ <projectId>topia</projectId>  - <eugeneVersion>2.4.2</eugeneVersion> - <nuitonUtilsVersion>2.5</nuitonUtilsVersion> + <eugeneVersion>2.5-SNAPSHOT</eugeneVersion> + <nuitonUtilsVersion>2.5.3</nuitonUtilsVersion> <processorPluginVersion>1.2.2</processorPluginVersion> <nuitonI18nVersion>2.4.1</nuitonI18nVersion> <xmlrpcVersion>3.1.2</xmlrpcVersion> <hibernateVersion>3.6.10.Final</hibernateVersion> - <sl4jVersion>1.6.4</sl4jVersion> - <h2Version>1.3.167</h2Version> + <sl4jVersion>1.6.6</sl4jVersion> + <h2Version>1.3.168</h2Version>  <i18n.bundles>fr_FR,en_GB,es_ES</i18n.bundles> @@ -352,7 +352,7 @@ <plugin> <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> + <artifactId>eugene-maven-plugin</artifactId> <version>${eugeneVersion}</version> <configuration> <inputs>zargo</inputs> Modified: branches/topia-2.6.x/topia-persistence/pom.xml =================================================================== --- branches/topia-2.6.x/topia-persistence/pom.xml 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-persistence/pom.xml 2012-08-14 15:48:02 UTC (rev 2611) @@ -214,7 +214,7 @@ <plugin> <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> + <artifactId>eugene-maven-plugin</artifactId> <configuration> </configuration> Modified: branches/topia-2.6.x/topia-persistence/src/it/ANOMALIE-1640/pom.xml =================================================================== --- branches/topia-2.6.x/topia-persistence/src/it/ANOMALIE-1640/pom.xml 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-persistence/src/it/ANOMALIE-1640/pom.xml 2012-08-14 15:48:02 UTC (rev 2611) @@ -109,7 +109,7 @@ <plugins> <plugin> <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> + <artifactId>eugene-maven-plugin</artifactId> <version>${eugeneVersion}</version> <configuration> <inputs>zargo</inputs> Deleted: branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst 2012-08-14 15:48:02 UTC (rev 2611) @@ -1,113 +0,0 @@ -.. - -.. * #%L -.. * ToPIA :: Persistence -.. * -.. * $Id$ -.. * $HeadURL$ -.. * %% -.. * Copyright (C) 2004 - 2010 CodeLutin -.. * %% -.. * This program is free software: you can redistribute it and/or modify -.. * it under the terms of the GNU Lesser General Public License as -.. * published by the Free Software Foundation, either version 3 of the -.. * License, or (at your option) any later version. -.. * -.. * This program is distributed in the hope that it will be useful, -.. * but WITHOUT ANY WARRANTY; without even the implied warranty of -.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.. * GNU General Lesser Public License for more details. -.. * -.. * You should have received a copy of the GNU General Lesser Public -.. * License along with this program. If not, see -.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. -.. * #L% -.. - - -====================== -Génération des modèles -====================== - - -Le module "topia-persistence" de topia est capable de -générer la persistence à partir d'un modèle UML. - -Nous allons détailler ici comme inclure la génération dans le -cycle de compilation maven. - - -Architecture maven ------------------- - -+---------------------------------+-----------------------------------------+ -| src/main/xmi/mymodel.zargo | exemple de modele UML avec argoUML | -+---------------------------------+-----------------------------------------+ -| src/main/xmi/mymodel.properties | fichier de propriétés attaché au modele | -+---------------------------------|-----------------------------------------+ - - -Configuration du pom.xml ------------------------- - -Pour générer les sources dans la phase "generate-sources" de maven, et utiliser -les sources générées, et faut configurer le pom. - -Plugin eugene -============= - -:: - -<plugin> - <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> -  - <version>1.0.0</version> - <executions> - <execution> - <id>Generator</id> - <phase>generate-sources</phase> - <configuration> - <srcDirUml>src/main/xmi</srcDirUml> - <srcXmiDest>target/generated-sources/xmi/</srcXmiDest> - <fullPackagePath>org.company.package</fullPackagePath> - <extractedPackages>org.company.package</extractedPackages> - <srcGenDest>target/generated-sources/objectmodel/</srcGenDest> - <includes>**/*.objectmodel</includes> - <templates>org.nuiton.topia.generator.TopiaMetaGenerator</templates> - <destDirGen>target/generated-sources/java</destDirGen> - <defaultPackage>org.company.package</defaultPackage> - </configuration> - <goals> - <goal>zargo2xmi</goal> - <goal>xmi2objectmodel</goal> - <goal>generate</goal> - </goals> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> -  - <version>2.2.0</version> - <scope>runtime</scope> - </dependency> - </dependencies> -</plugin> - -Pour plus d'information à propos d'eugene, merci de consulter le site : -http://maven-site.nuiton.org/eugene/ - -Dépendances du projet -===================== - -Il faut enfin ajouter "topia-persistence" en dépendance du projet : - -:: - -<dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> -  - <version>2.2.0</version> - <scope>compile</scope> -</dependency> Copied: branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm (from rev 2609, branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst) =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm (rev 0) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm 2012-08-14 15:48:02 UTC (rev 2611) @@ -0,0 +1,102 @@ +.. - +.. * #%L +.. * ToPIA :: Persistence +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2004 - 2010 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Lesser General Public License as +.. * published by the Free Software Foundation, either version 3 of the +.. * License, or (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Lesser Public License for more details. +.. * +.. * You should have received a copy of the GNU General Lesser Public +.. * License along with this program. If not, see +.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. +.. * #L% +.. - + +====================== +Génération des modèles +====================== + + +Le module "topia-persistence" de topia est capable de +générer la persistence à partir d'un modèle UML. + +Nous allons détailler ici comme inclure la génération dans le +cycle de compilation maven. + + +Architecture maven +------------------ + ++---------------------------------+-----------------------------------------+ +| src/main/xmi/mymodel.zargo | exemple de modele UML avec argoUML | ++---------------------------------+-----------------------------------------+ +| src/main/xmi/mymodel.properties | fichier de propriétés attaché au modele | ++---------------------------------|-----------------------------------------+ + + +Configuration du pom.xml +------------------------ + +Pour générer les sources dans la phase "generate-sources" de maven, et utiliser +les sources générées, et faut configurer le pom. + +Plugin eugene +============= + +:: + +<plugin> + <groupId>org.nuiton.eugene</groupId> + <artifactId>eugene-maven-plugin</artifactId> + <version>${eugeneVersion}</version> + <executions> + <execution> + <id>Generator</id> + <phase>generate-sources</phase> + <configuration> + <inputs>zargo</inputs> + <fullPackagePath>org.company.package</fullPackagePath> + <extractedPackages>org.company.package</extractedPackages> + <templates>org.nuiton.topia.generator.TopiaMetaGenerator</templates> + <defaultPackage>org.company.package</defaultPackage> + </configuration> + <goals> + <goal>generate</goal> + </goals> + </execution> + </executions> + <dependencies> + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${project.version}</version> + </dependency> + </dependencies> +</plugin> + +Pour plus d'information à propos d'eugene, merci de consulter le site : +http://maven-site.nuiton.org/eugene/ + +Dépendances du projet +===================== + +Il faut enfin ajouter "topia-persistence" en dépendance du projet : + +:: + +<dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${project.version}</version> +</dependency> Property changes on: branches/topia-2.6.x/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Deleted: branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst 2012-08-14 15:48:02 UTC (rev 2611) @@ -1,157 +0,0 @@ -.. - -.. * #%L -.. * ToPIA :: Persistence -.. * -.. * $Id$ -.. * $HeadURL$ -.. * %% -.. * 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 -.. * published by the Free Software Foundation, either version 3 of the -.. * License, or (at your option) any later version. -.. * -.. * This program is distributed in the hope that it will be useful, -.. * but WITHOUT ANY WARRANTY; without even the implied warranty of -.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.. * GNU General Lesser Public License for more details. -.. * -.. * You should have received a copy of the GNU General Lesser Public -.. * License along with this program. If not, see -.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. -.. * #L% -.. - - -====== -How to -====== - -Ce document a pour objectif de prendre en main le framework Topia. Le document -est constitué de 4 parties, la modélisation, la génération, la configuration et -l'utilisation. - -Modélisation ------------- - -La première étape constiste à réaliser le modèle UML soit avec Argouml -(http://argouml.tigris.org) soit avec Poséidon (http://www.gentleware.com) - -Le stérotype «entity» sur les classes permet de préciser que la classe est -persistée par Topia. D'autre stérotypes (extern, service, ...) sont disponibles -mais ne sont pas présentés. - -Le fichier de modélisation peut être complété par un fichier de configuration -nommé <nom fichier modélisation>.properties. Il contient des informations -techniques propres aux librairies utilisé par Topia. - -Exemple : - -:: - - # Précise comment est mappé un type - # model.tagvalue.<type java>=<type base de donnée> - model.tagvalue.java.lang.String=text - - # Précise le schema de la base de données par défaut - # model.tagvalue.dbSchema=<nom schéma> - model.tagvalue.dbSchema=test - - # Précise l'entête de l'ensemble des fichiers générés - # model.tagvalue.copyright=<valeur> - 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 - org.codelutin.Person.attribute.association.tagvalue.lazy=false - -Génération ----------- - -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.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> - <version>2.3.2</version> - <executions> - <execution> - <phase>process-sources</phase> -  - <configuration> - <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>smart-generate</goal> - </goals> - </execution> - </executions> - <dependencies> - <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> - <version>2.5.2</version> - <scope>compile</scope> - </dependency> - </dependencies> - </plugin> - -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 -``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 : - -:: - - <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> - <version>2.5.2</version> - <scope>compile</scope> - </dependency> - -Pour une classe modélisée, nous retrouvons 6 fichiers : - * Une interface - * Une classe abstraite - * Une implantation - * Une configuration hibernate - * Un DAO abstrait - * Une implantation du DAO - -Une classe Helper est aussi générée, permettant l'accès à l'ensemble des DAO. - -Configuration -------------- - -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``. - - -Utilisation ------------ - -Implantation des méthodes -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si des méthodes ont été définies dans le modèle de données, il faut créer -l'implantation correspondante. Le paquetage doit porter le même nom que celui de -la génération. - - - -.. _Eugene: http://maven-site.nuiton.org/eugene/ Copied: branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst.vm (from rev 2609, branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst) =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst.vm (rev 0) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst.vm 2012-08-14 15:48:02 UTC (rev 2611) @@ -0,0 +1,156 @@ +.. - +.. * #%L +.. * ToPIA :: Persistence +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * 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 +.. * published by the Free Software Foundation, either version 3 of the +.. * License, or (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Lesser Public License for more details. +.. * +.. * You should have received a copy of the GNU General Lesser Public +.. * License along with this program. If not, see +.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. +.. * #L% +.. - + +====== +How to +====== + +Ce document a pour objectif de prendre en main le framework Topia. Le document +est constitué de 4 parties, la modélisation, la génération, la configuration et +l'utilisation. + +Modélisation +------------ + +La première étape constiste à réaliser le modèle UML soit avec Argouml +(http://argouml.tigris.org) soit avec Poséidon (http://www.gentleware.com) + +Le stérotype «entity» sur les classes permet de préciser que la classe est +persistée par Topia. D'autre stérotypes (extern, service, ...) sont disponibles +mais ne sont pas présentés. + +Le fichier de modélisation peut être complété par un fichier de configuration +nommé <nom fichier modélisation>.properties. Il contient des informations +techniques propres aux librairies utilisé par Topia. + +Exemple : + +:: + + # Précise comment est mappé un type + # model.tagvalue.<type java>=<type base de donnée> + model.tagvalue.java.lang.String=text + + # Précise le schema de la base de données par défaut + # model.tagvalue.dbSchema=<nom schéma> + model.tagvalue.dbSchema=test + + # Précise l'entête de l'ensemble des fichiers générés + # model.tagvalue.copyright=<valeur> + 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 + org.codelutin.Person.attribute.association.tagvalue.lazy=false + +Génération +---------- + +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.nuiton.eugene</groupId> + <artifactId>eugene-maven-plugin</artifactId> + <version>${eugeneVersion}</version> + <executions> + <execution> + <phase>process-sources</phase> +  + <configuration> + <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>generate</goal> + </goals> + </execution> + </executions> + <dependencies> + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${project.version}</version> + </dependency> + </dependencies> + </plugin> + +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 +``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 : + +:: + + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>2.5.2</version> + <scope>compile</scope> + </dependency> + +Pour une classe modélisée, nous retrouvons 6 fichiers : + * Une interface + * Une classe abstraite + * Une implantation + * Une configuration hibernate + * Un DAO abstrait + * Une implantation du DAO + +Une classe Helper est aussi générée, permettant l'accès à l'ensemble des DAO. + +Configuration +------------- + +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``. + + +Utilisation +----------- + +Implantation des méthodes +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Si des méthodes ont été définies dans le modèle de données, il faut créer +l'implantation correspondante. Le paquetage doit porter le même nom que celui de +la génération. + + + +.. _Eugene: http://maven-site.nuiton.org/eugene/ Property changes on: branches/topia-2.6.x/topia-persistence/src/site/rst/user/howto.rst.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Deleted: branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst 2012-08-14 15:48:02 UTC (rev 2611) @@ -1,247 +0,0 @@ -.. - -.. * #%L -.. * ToPIA :: Persistence -.. * -.. * $Id$ -.. * $HeadURL$ -.. * %% -.. * Copyright (C) 2004 - 2011 CodeLutin -.. * %% -.. * This program is free software: you can redistribute it and/or modify -.. * it under the terms of the GNU Lesser General Public License as -.. * published by the Free Software Foundation, either version 3 of the -.. * License, or (at your option) any later version. -.. * -.. * This program is distributed in the hope that it will be useful, -.. * but WITHOUT ANY WARRANTY; without even the implied warranty of -.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the -.. * GNU General Lesser Public License for more details. -.. * -.. * You should have received a copy of the GNU General Lesser Public -.. * License along with this program. If not, see -.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. -.. * #L% -.. - - -================================ -Démarrer un projet ToPIA - Maven -================================ - -Comment démarrer un projet à partir de rien. - -Créer le projet -=============== - -Pour commencer, il faut créer un projet maven en respectant les conventions -habituelles. Partons d'un projet maven vide : - -:: - - mvn archetype:generate -DgroupId=com.masociete -DartifactId=monapplication -DarchetypeArtifactId=maven-archetype-archetype - -Ajoutez un dossier ``src/main/xmi``, c'est ici que nous allons placer le modèle. - -:: - - topia-tutorial - ├── pom.xml - └── src - ├── main - │ ├── java - │ │ └── org - │ │ └── nuiton - │ │ └── topia - │ │ └── tutorial - │ │ └── library - │ ├── resources - │ │ ├── library-config.properties - │ │ └── log4j.properties - │ └── xmi - │ ├── library.properties - │ └── library.zargo - └── test - ├── java - └── resources - -Dans le pom, on ajoute ToPIA en dépendance, et on configure la génération : - -:: - - <properties> - <topiaVersion>2.5.4</topiaVersion> - <eugeneVersion>2.3.3</eugeneVersion> - </properties> - - <dependencies> - <dependency> - <groupId>org.nuiton.topia</groupId> - <artifactId>topia-persistence</artifactId> - <version>${topiaVersion}</version> - </dependency> - </dependencies> - - - <plugins> - -  - - <plugin> - <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> - <version>${eugeneVersion}</version> - <configuration> - <inputs>zargo</inputs> - <resolver>org.nuiton.util.FasterCachedResourceResolver</resolver> - </configuration> - <executions> - <execution> - <id>generate-entities</id> - <phase>generate-sources</phase> - <configuration> -  - <fullPackagePath>org.nuiton.topia.tutorial.library</fullPackagePath> -  - <defaultPackage>org.nuiton.topia.tutorial.library.model</defaultPackage> - <templates> - org.nuiton.topia.generator.TopiaMetaTransformer - </templates> - </configuration> - <goals> - <goal>smart-generate</goal> - </goals> - </execution> - </executions> - </plugin> - - </plugins> - - -Créer le modèle -=============== - -Utiliser ArgoUML pour décrire le modèle ---------------------------------------- - -Avec ArgoUML, créez un nouveau modèle et enregistrez-le dans ``xmi``. Nous -allons créer un modèle simplifié pour une application de gestion de -bibliothèque. - -Nous avons modélisé les entités ``Book`` et ``Author`` avec les champs -appropriés. Faites attention à bien placer les entités dans le bon package, sinon -elles ne seront pas générées. Pour que ToPIA sache que ces classes décrivent -des entités qui ont vocation à être sauvées en base, il faut leur ajouter le -stéréotype ``entity``. - -N'oubliez pas de donner un nom et une version au modèle. - -Les données associées aux éléments du modèle --------------------------------------------- - -Le modeleur n'est pas suffisant pour décrire toute les subtilités du modèle. -Le modèle se voulant indépendant de la plate-forme cible, on ne peut y inclure -directement des notions spécifiques à ToPIA. C'est pourquoi nous allons pouvoir -ajouter ces informations spécifiques via le fichier ``library-config.properties``. - - -C'est prêt ! -============ - -Il suffit de construire l'application avec maven. - -:: - - mvn compile - - -La compilation va provoquer la phase de génération. Si on examine le contenu -de notre dossier target : - -:: - - topia-tutorial - ├── pom.xml - ├── src - │ ├── main - │ │ ├── java - │ │ │ └── org - │ │ │ └── nuiton - │ │ │ └── topia - │ │ │ └── tutorial - │ │ │ └── library - │ │ ├── resources - │ │ │ ├── library-config.properties - │ │ │ └── log4j.properties - │ │ └── xmi - │ │ ├── library.properties - │ │ └── library.zargo - │ └── test - │ ├── java - │ └── resources - └── target - ├── classes - │ ├── library-config.properties - │ ├── log4j.properties - │ └── org - │ └── nuiton - │ └── topia - │ └── tutorial - │ └── library - │ ├── LibraryConfig.class - │ └── model - │ ├── AuthorAbstract.class - │ ├── Author.class - │ ├── AuthorDAOAbstract.class - │ . - │ . - │ . - └── generated-sources - ├── annotations - ├── java - │ └── org - │ └── nuiton - │ └── topia - │ └── tutorial - │ └── library - │ └── model - │ ├── AuthorAbstract.java - │ ├── AuthorDAOAbstract.java - │ ├── AuthorDAOImpl.java - │ ├── AuthorDAO.java - │ ├── AuthorImpl.hbm.xml - │ ├── Author.java - │ ├── BookAbstract.java - │ ├── BookDAOAbstract.java - │ ├── BookDAOImpl.java - │ ├── BookDAO.java - │ ├── BookImpl.hbm.xml - │ ├── BookImpl.java - │ ├── Book.java - │ └── LibraryDAOHelper.java - ├── models - │ ├── library.objectmodel - │ └── library.properties - └── xmi - ├── library.properties - └── library.xmi - - - -On peut voir que ToPIA a généré ``LibraryDAOHelper`` qui va nous permettre de -récupérer les différents DAO et, pour chaque entité de notre modèle : - * Une interface - * Une classe abstraite, qui implémente déjà tout le contrat - * Une implantation (vide, seulement les constructeurs) - * Un DAO abstrait - * Une implantation du DAO - * Un fichier de mapping hibernate (*.hbm.xml) - -Comme il s'agit d'une phase de compilation, maven va ajouter tout le code généré aux -classpath le code généré sera compilé et lié en même temps que le reste de votre application. -Tous les fichiers .class se retrouveront dans target/classes, dans la suite du processus, on -ne distingue plus le code généré du code utilisateur. - -Par la suite, si vous changez le modèle, tout sera re-généré. À chaque ``clean`` -via maven, tout ce qui a été généré est effacé. Vous pouvez donc re-généré autant -de fois que nécessaire. Attention, Maven ne détecte pas le changement du modèle -si le fichier .zargo a été modifié : il faut donc faire un clean à chaque fois -afin de forcer le re-génération du modèle dans sa dernière version. Copied: branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst.vm (from rev 2609, branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst) =================================================================== --- branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst.vm (rev 0) +++ branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst.vm 2012-08-14 15:48:02 UTC (rev 2611) @@ -0,0 +1,247 @@ +.. - +.. * #%L +.. * ToPIA :: Persistence +.. * +.. * $Id$ +.. * $HeadURL$ +.. * %% +.. * Copyright (C) 2004 - 2011 CodeLutin +.. * %% +.. * This program is free software: you can redistribute it and/or modify +.. * it under the terms of the GNU Lesser General Public License as +.. * published by the Free Software Foundation, either version 3 of the +.. * License, or (at your option) any later version. +.. * +.. * This program is distributed in the hope that it will be useful, +.. * but WITHOUT ANY WARRANTY; without even the implied warranty of +.. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.. * GNU General Lesser Public License for more details. +.. * +.. * You should have received a copy of the GNU General Lesser Public +.. * License along with this program. If not, see +.. * <http://www.gnu.org/licenses/lgpl-3.0.html>. +.. * #L% +.. - + +================================ +Démarrer un projet ToPIA - Maven +================================ + +Comment démarrer un projet à partir de rien. + +Créer le projet +=============== + +Pour commencer, il faut créer un projet maven en respectant les conventions +habituelles. Partons d'un projet maven vide : + +:: + + mvn archetype:generate -DgroupId=com.masociete -DartifactId=monapplication -DarchetypeArtifactId=maven-archetype-archetype + +Ajoutez un dossier ``src/main/xmi``, c'est ici que nous allons placer le modèle. + +:: + + topia-tutorial + ├── pom.xml + └── src + ├── main + │ ├── java + │ │ └── org + │ │ └── nuiton + │ │ └── topia + │ │ └── tutorial + │ │ └── library + │ ├── resources + │ │ ├── library-config.properties + │ │ └── log4j.properties + │ └── xmi + │ ├── library.properties + │ └── library.zargo + └── test + ├── java + └── resources + +Dans le pom, on ajoute ToPIA en dépendance, et on configure la génération : + +:: + + <properties> + <topiaVersion>${project.version}</topiaVersion> + <eugeneVersion>${eugeneVersion}</eugeneVersion> + </properties> + + <dependencies> + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${topiaVersion}</version> + </dependency> + </dependencies> + + + <plugins> + +  + + <plugin> + <groupId>org.nuiton.eugene</groupId> + <artifactId>eugene-maven-plugin</artifactId> + <version>${eugeneVersion}</version> + <configuration> + <inputs>zargo</inputs> + <resolver>org.nuiton.util.FasterCachedResourceResolver</resolver> + </configuration> + <executions> + <execution> + <id>generate-entities</id> + <phase>generate-sources</phase> + <configuration> +  + <fullPackagePath>org.nuiton.topia.tutorial.library</fullPackagePath> +  + <defaultPackage>org.nuiton.topia.tutorial.library.model</defaultPackage> + <templates> + org.nuiton.topia.generator.TopiaMetaTransformer + </templates> + </configuration> + <goals> + <goal>generate</goal> + </goals> + </execution> + </executions> + </plugin> + + </plugins> + + +Créer le modèle +=============== + +Utiliser ArgoUML pour décrire le modèle +--------------------------------------- + +Avec ArgoUML, créez un nouveau modèle et enregistrez-le dans ``xmi``. Nous +allons créer un modèle simplifié pour une application de gestion de +bibliothèque. + +Nous avons modélisé les entités ``Book`` et ``Author`` avec les champs +appropriés. Faites attention à bien placer les entités dans le bon package, sinon +elles ne seront pas générées. Pour que ToPIA sache que ces classes décrivent +des entités qui ont vocation à être sauvées en base, il faut leur ajouter le +stéréotype ``entity``. + +N'oubliez pas de donner un nom et une version au modèle. + +Les données associées aux éléments du modèle +-------------------------------------------- + +Le modeleur n'est pas suffisant pour décrire toute les subtilités du modèle. +Le modèle se voulant indépendant de la plate-forme cible, on ne peut y inclure +directement des notions spécifiques à ToPIA. C'est pourquoi nous allons pouvoir +ajouter ces informations spécifiques via le fichier ``library-config.properties``. + + +C'est prêt ! +============ + +Il suffit de construire l'application avec maven. + +:: + + mvn compile + + +La compilation va provoquer la phase de génération. Si on examine le contenu +de notre dossier target : + +:: + + topia-tutorial + ├── pom.xml + ├── src + │ ├── main + │ │ ├── java + │ │ │ └── org + │ │ │ └── nuiton + │ │ │ └── topia + │ │ │ └── tutorial + │ │ │ └── library + │ │ ├── resources + │ │ │ ├── library-config.properties + │ │ │ └── log4j.properties + │ │ └── xmi + │ │ ├── library.properties + │ │ └── library.zargo + │ └── test + │ ├── java + │ └── resources + └── target + ├── classes + │ ├── library-config.properties + │ ├── log4j.properties + │ └── org + │ └── nuiton + │ └── topia + │ └── tutorial + │ └── library + │ ├── LibraryConfig.class + │ └── model + │ ├── AuthorAbstract.class + │ ├── Author.class + │ ├── AuthorDAOAbstract.class + │ . + │ . + │ . + └── generated-sources + ├── annotations + ├── java + │ └── org + │ └── nuiton + │ └── topia + │ └── tutorial + │ └── library + │ └── model + │ ├── AuthorAbstract.java + │ ├── AuthorDAOAbstract.java + │ ├── AuthorDAOImpl.java + │ ├── AuthorDAO.java + │ ├── AuthorImpl.hbm.xml + │ ├── Author.java + │ ├── BookAbstract.java + │ ├── BookDAOAbstract.java + │ ├── BookDAOImpl.java + │ ├── BookDAO.java + │ ├── BookImpl.hbm.xml + │ ├── BookImpl.java + │ ├── Book.java + │ └── LibraryDAOHelper.java + ├── models + │ ├── library.objectmodel + │ └── library.properties + └── xmi + ├── library.properties + └── library.xmi + + + +On peut voir que ToPIA a généré ``LibraryDAOHelper`` qui va nous permettre de +récupérer les différents DAO et, pour chaque entité de notre modèle : + * Une interface + * Une classe abstraite, qui implémente déjà tout le contrat + * Une implantation (vide, seulement les constructeurs) + * Un DAO abstrait + * Une implantation du DAO + * Un fichier de mapping hibernate (*.hbm.xml) + +Comme il s'agit d'une phase de compilation, maven va ajouter tout le code généré aux +classpath le code généré sera compilé et lié en même temps que le reste de votre application. +Tous les fichiers .class se retrouveront dans target/classes, dans la suite du processus, on +ne distingue plus le code généré du code utilisateur. + +Par la suite, si vous changez le modèle, tout sera re-généré. À chaque ``clean`` +via maven, tout ce qui a été généré est effacé. Vous pouvez donc re-généré autant +de fois que nécessaire. Attention, Maven ne détecte pas le changement du modèle +si le fichier .zargo a été modifié : il faut donc faire un clean à chaque fois +afin de forcer le re-génération du modèle dans sa dernière version. Property changes on: branches/topia-2.6.x/topia-persistence/src/site/rst/user/start.rst.vm ___________________________________________________________________ Added: svn:keywords + Author Date Id Revision HeadURL Added: svn:eol-style + native Modified: branches/topia-2.6.x/topia-service-security/pom.xml =================================================================== --- branches/topia-2.6.x/topia-service-security/pom.xml 2012-08-14 15:45:47 UTC (rev 2610) +++ branches/topia-2.6.x/topia-service-security/pom.xml 2012-08-14 15:48:02 UTC (rev 2611) @@ -119,8 +119,6 @@   - <packaging>jar</packaging> - <build> <resources> @@ -138,7 +136,7 @@ <plugin> <groupId>org.nuiton.eugene</groupId> - <artifactId>maven-eugene-plugin</artifactId> + <artifactId>eugene-maven-plugin</artifactId> <executions> <execution> <id>generate-sources</id> @@ -152,7 +150,7 @@ <overwrite>true</overwrite> </configuration> <goals> - <goal>smart-generate</goal> + <goal>generate</goal> </goals> </execution> </executions>

1 0

r2610 - branches/topia-2.6.x
by tchemit＠users.nuiton.org Aug. 14, 2012

Aug. 14, 2012

Author: tchemit Date: 2012-08-14 17:45:47 +0200 (Tue, 14 Aug 2012) New Revision: 2610 Url: http://nuiton.org/repositories/revision/topia/2610 Log: remove from svn old modules (don't worry nothing is lost) Removed: branches/topia-2.6.x/topia-service-history/ branches/topia-2.6.x/topia-service-index/ branches/topia-2.6.x/topia-soa/ branches/topia-2.6.x/topia-tutorial/

1 0

r2609 - branches/topia-2.6.x
by tchemit＠users.nuiton.org Aug. 7, 2012

Aug. 7, 2012

Author: tchemit Date: 2012-08-07 09:51:41 +0200 (Tue, 07 Aug 2012) New Revision: 2609 Url: http://nuiton.org/repositories/revision/topia/2609 Log: Update mavenpom4redmine to 3.3.5. Modified: branches/topia-2.6.x/pom.xml Modified: branches/topia-2.6.x/pom.xml =================================================================== --- branches/topia-2.6.x/pom.xml 2012-08-07 07:51:38 UTC (rev 2608) +++ branches/topia-2.6.x/pom.xml 2012-08-07 07:51:41 UTC (rev 2609) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmineAndCentral</artifactId> - <version>3.3.4</version> + <version>3.3.5</version> </parent> <artifactId>topia</artifactId>

1 0

r2608 - trunk
by tchemit＠users.nuiton.org Aug. 7, 2012

Aug. 7, 2012

Author: tchemit Date: 2012-08-07 09:51:38 +0200 (Tue, 07 Aug 2012) New Revision: 2608 Url: http://nuiton.org/repositories/revision/topia/2608 Log: Update mavenpom4redmine to 3.3.5. Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2012-07-09 16:44:29 UTC (rev 2607) +++ trunk/pom.xml 2012-08-07 07:51:38 UTC (rev 2608) @@ -32,7 +32,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmineAndCentral</artifactId> - <version>3.3.4</version> + <version>3.3.5</version> </parent> <artifactId>topia</artifactId>

1 0