Author: athimel Date: 2013-08-05 11:30:26 +0200 (Mon, 05 Aug 2013) New Revision: 2791 Url: http://nuiton.org/projects/topia/repository/revisions/2791 Log: refs #1146 Start documentation re-arrangement Added: trunk/src/site/resources/ClassDiagram_BookAuthor.png trunk/src/site/resources/ClassDiagram_BookAuthorWithOperation.png trunk/src/site/resources/ContactUseCases.png trunk/src/site/resources/ServiceCall.png trunk/src/site/resources/modelForTopiaQuery.png trunk/src/site/resources/modelForTopiaQuery.zargo trunk/src/site/resources/topia.zargo trunk/src/site/rst/TopiaDocumentation.rst trunk/src/site/rst/devel/ trunk/src/site/rst/user/ Removed: trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthor.png trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthorWithOperation.png trunk/topia-persistence/src/site/resources/ContactUseCases.png trunk/topia-persistence/src/site/resources/ServiceCall.png trunk/topia-persistence/src/site/resources/modelForTopiaQuery.png trunk/topia-persistence/src/site/resources/modelForTopiaQuery.zargo trunk/topia-persistence/src/site/resources/topia.zargo trunk/topia-persistence/src/site/rst/TopiaDocumentation.rst trunk/topia-persistence/src/site/rst/devel/ trunk/topia-persistence/src/site/rst/user/ Modified: trunk/pom.xml trunk/src/site/rst/index.rst trunk/src/site/rst/migrate_to_3.0.rst trunk/src/site/rst/user/FAQ.rst trunk/src/site/rst/user/ModelGeneration.rst.vm trunk/src/site/rst/user/start.rst.vm trunk/src/site/site_fr.xml trunk/topia-persistence/src/site/rst/index.rst trunk/topia-persistence/src/site/site_fr.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/pom.xml 2013-08-05 09:30:26 UTC (rev 2791) @@ -58,6 +58,9 @@ <!-- pour un muli module on doit fixer le projectId --> <projectId>topia</projectId> + <!-- do not relativize links in generated site --> + <relativizeDecorationLinks>false</relativizeDecorationLinks> + <!-- libs version --> <eugeneVersion>2.7</eugeneVersion> <nuitonUtilsVersion>2.7</nuitonUtilsVersion> Copied: trunk/src/site/resources/ClassDiagram_BookAuthor.png (from rev 2789, trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthor.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/ClassDiagram_BookAuthorWithOperation.png (from rev 2789, trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthorWithOperation.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/ContactUseCases.png (from rev 2789, trunk/topia-persistence/src/site/resources/ContactUseCases.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/ServiceCall.png (from rev 2789, trunk/topia-persistence/src/site/resources/ServiceCall.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/modelForTopiaQuery.png (from rev 2789, trunk/topia-persistence/src/site/resources/modelForTopiaQuery.png) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/modelForTopiaQuery.zargo (from rev 2789, trunk/topia-persistence/src/site/resources/modelForTopiaQuery.zargo) =================================================================== (Binary files differ) Copied: trunk/src/site/resources/topia.zargo (from rev 2789, trunk/topia-persistence/src/site/resources/topia.zargo) =================================================================== (Binary files differ) Copied: trunk/src/site/rst/TopiaDocumentation.rst (from rev 2789, trunk/topia-persistence/src/site/rst/TopiaDocumentation.rst) =================================================================== --- trunk/src/site/rst/TopiaDocumentation.rst (rev 0) +++ trunk/src/site/rst/TopiaDocumentation.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -0,0 +1,69 @@ +.. - +.. * #%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% +.. - + +===== +ToPIA +===== + +Buts +==== + +- Abstraction de la persistence +- Sauvegarde/restauration en XML +- Sécurité sur les instances d'objets +- Génération de code même si ce n'est pas un prérequis pour utiliser ToPIA + +Ce qu'il serait bien de récuperer par rapport à la version 2 + +- support des sous-transactions + +Peut-être plus tard + +- Gestion des services +- Distribution transparente + +La vision ToPIA +=============== + +Un point d'entrée le TopiaContext sur lequel on ouvre des transactions ce qui +retourne un autre TopiaContext à partir duquel on récupère les DAO des +différentes entités qui permettent de faire les traitements que l'on souhaite. + +Ensuite on peut appeler la methode commit de ce sous TopiaContext pour mettre +à jour la base de données et permettre à d'autres TopiaContext d'avoir la +nouvelle vision de nos objets. + +Chaque TopiaContext créé sur le TopiaContext root est indépendant. + +Lorsque l'on travaille avec un objet provenant d'un TopiaContext sur lequel +on a fait un rollback, celui-ci n'est plus valide et il vaut mieux en recupérer +une version correcte sur le TopiaContext. + +Après avoir fait un commit ou un rollback sur un TopiaContext on peut continuer +a l'utiliser et refaire des commits pour synchroniser de temps en temps les +modification faites sur la base. + +Un TopiaContext peu servir aussi longtemps que l'on souhaite, il ne maintient +pas inutilement de transaction sur la base. Modified: trunk/src/site/rst/index.rst =================================================================== --- trunk/src/site/rst/index.rst 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/src/site/rst/index.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -27,26 +27,102 @@ Accueil ======= -Presentation ------------- +.. contents:: -ToPIA stands for Tools for Portable and Independent Architecture. It is a -technical platform abstraction framework. This documentation is not up-to-date -and in French. We are in the process to update this documentation, we will -translate it in English at the same time. - Présentation ------------ ToPIA, pour Tools for Portable and Independant Architecture, est un framework d'abstraction des plateformes techniques. + +C'est à dire ? +~~~~~~~~~~~~~~ + +Le cycle de développement en Y traditionnel peut être représenté de la manière +suivante : + +Les deux branches, la branche fonctionnelle, porteuse de la solution logique, et +la branche technique, qui définit la plateforme technique sur laquelle la +solution sera implantée, se rejoignent en amont de la conception détaillée et du +codage. Cette projection peut être accompagnée de génération de code, mais il +reste toujours une certaine quantité de code écrite à la main. + +Cette séparation des responsabilités et ce processsus donne pleine satisfaction +lors du développement initial d'un logiciel. La vie d'un logiciel commence +toutefois au moment de sa mise en production et les évolutions qui y seront +apportées sont de deux natures : + + - Évolutions fonctionnelles : Ajout de fonctionnalités, correction de bugs, ... + - Evolutions techniques : Changement de bases de données, changement de techno + sur les UI, nouveaux accès (SOAP ?), ... + +Si les évolutions fonctionnelles sont prises en compte par la nature itérative +des processus de développement, les évolutions techniques sont elles difficiles. + +Comment passer d'hibernate à JDO, de Swing au client léger, des EJB aux +conteneurs légers ? En supprimant les dépendances de votre code sur les briques +techniques, en codant sur une plateforme technique abstraite, interfaces et +facades au travers desquels vous pourrez manipuler les différentes solutions +techniques que vous retiendrez. Hibernate et JDO ne sont que deux API d'accès +aux données; Swing et client léger, des UI; les EJB et les conteneurs légers, +des logiques métiers déportées... + +Et ToPIA alors ? +~~~~~~~~~~~~~~~~ + +ToPIA propose une telle plateforme. Vous codez en regard d'une API qui abstrait +la distribution (1-tiers ?, 2-tiers ?, 3-tiers ?, n-tiers ? quels protocoles +d'accès ?), la persistence (quelles bases bien sûr, mais également quel +framework ?, quelle API de requètage (EJB-QL, JDO-QL, ... ?), quel méchanisme +transactionnel ?), quelle UI ? Puis vous projettez votre application sur la +palteforme de votre choix. + +Fonctionnement classique +------------------------ + +Le framework ToPIA permet dans un projet de générer la partie métier de l'application, +c'est à dire les classes JAVA ainsi que le mapping Hibernate pour la persistance. +Cela représente un travail considérable en moins pour le développeur et une +flexibilité importante dans les évolutions futures de la parties métier. + +L'utilisation du framework ToPIA se découpe en plusieurs phases, elles sont +itératives : + + 1. Création du diagramme de classe sur ArgoUML_ par exemple + 2. Exportation du modèle en XMI + 3. Génération des fichiers JAVA et Hibernate par Eugene_ + 4. Implentation des méthodes + +ToPIA-service +------------- + +Le framework ToPIA peut être complêté par une multitude de services. Il existe +actuellement trois : + + - `service pour la sécurité`_ : permet la gestion des authentification et des + autorisations. Il repose sur le mécanisme de JAAS. + - `service pour la gestion des mises à jour`_ : permet de mettre à jour une version + de base à partir d'un modèle versionné. + - `service de réplication`_ : permet de répliquer des données de base à base. + - ``service pour la gestion d'un historique`` : permet de conserver l'ensemble des + actions réalisées sur la base de données (**plus maintenu depuis la 2.3.3**). + - ``service pour la recherche`` : permet de rechercher un mot clé parmis les entités + de l'application. Il repose sur la librairie lucene d'apache (**plus maintenu depuis la 2.3.3**). + +.. _service pour la sécurité: ../topia-service-security +.. _service pour la gestion des mises à jour: ../topia-service-migration +.. _service de réplication: ../topia-service-replication +.. _Eugene: http://maven-site.nuiton.org/eugene/ +.. _ArgoUML: http://argouml.tigris.org/ + + Constitution ------------ Il est actuellement composé d'un module principal : - * `ToPIA-persistence`_ : pour la gestion de la persistance sur hibernate + * `ToPIA-persistence`_ : pour la gestion de la persistance sur Hibernate Depuis la version 2.3.3, le module **ToPIA-soa** n'est plus maintenu. Modified: trunk/src/site/rst/migrate_to_3.0.rst =================================================================== --- trunk/src/site/rst/migrate_to_3.0.rst 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/src/site/rst/migrate_to_3.0.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -26,6 +26,7 @@ Migrer depuis ToPIA 2.x vers 3.0 ================================ +.. contents:: Gestion des dépendances Modified: trunk/src/site/rst/user/FAQ.rst =================================================================== --- trunk/topia-persistence/src/site/rst/user/FAQ.rst 2013-08-05 08:22:58 UTC (rev 2789) +++ trunk/src/site/rst/user/FAQ.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -23,9 +23,9 @@ .. * #L% .. - -=== -FAQ -=== +========================== +Frequently Asked Questions +========================== Problème lors du chargement d'une entity ======================================== Modified: trunk/src/site/rst/user/ModelGeneration.rst.vm =================================================================== --- trunk/topia-persistence/src/site/rst/user/ModelGeneration.rst.vm 2013-08-05 08:22:58 UTC (rev 2789) +++ trunk/src/site/rst/user/ModelGeneration.rst.vm 2013-08-05 09:30:26 UTC (rev 2791) @@ -51,41 +51,41 @@ 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 Eugene ============= :: -<plugin> + <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> + <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> + <dependency> + <groupId>org.nuiton.topia</groupId> + <artifactId>topia-persistence</artifactId> + <version>${project.version}</version> + </dependency> </dependencies> -</plugin> + </plugin> -Pour plus d'information à propos d'eugene, merci de consulter le site : +Pour plus d'information à propos d'Eugene, merci de consulter le site : http://maven-site.nuiton.org/eugene/ Dépendances du projet @@ -95,8 +95,8 @@ :: -<dependency> + <dependency> <groupId>org.nuiton.topia</groupId> <artifactId>topia-persistence</artifactId> <version>${project.version}</version> -</dependency> + </dependency> Modified: trunk/src/site/rst/user/start.rst.vm =================================================================== --- trunk/topia-persistence/src/site/rst/user/start.rst.vm 2013-08-05 08:22:58 UTC (rev 2789) +++ trunk/src/site/rst/user/start.rst.vm 2013-08-05 09:30:26 UTC (rev 2791) @@ -228,6 +228,7 @@ 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) Modified: trunk/src/site/site_fr.xml =================================================================== --- trunk/src/site/site_fr.xml 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/src/site/site_fr.xml 2013-08-05 09:30:26 UTC (rev 2791) @@ -27,7 +27,7 @@ <project name="ToPIA"> <bannerLeft> - <src alt="ToPIA">http://maven-site.nuiton.org/public/images/logos/topia-logo.png</src> + <!--<src alt="ToPIA">http://maven-site.nuiton.org/public/images/logos/topia-logo.png</src>--> <name>${project.name}</name> <href>index.html</href> </bannerLeft> @@ -45,9 +45,15 @@ <custom> <fluidoSkin> - <topBarEnabled>false</topBarEnabled> - <googleSearch/> - <sideBarEnabled>true</sideBarEnabled> + <topBarEnabled>true</topBarEnabled> + <topBarIcon> + <name>ToPIA</name> + <alt>ToPIA</alt> + <src><!-- TODO Create a 108*20 px icon --></src> + <href>/index.html</href> + </topBarIcon> + <sideBarEnabled>false</sideBarEnabled> + <googleSearch>false</googleSearch> <searchEnabled>true</searchEnabled> <sourceLineNumbersEnabled>true</sourceLineNumbersEnabled> </fluidoSkin> @@ -87,14 +93,43 @@ <item href="http://maven-site.nuiton.org/topia" name="${project.name}"/> </breadcrumbs> - <menu name="Utilisateur"> - <item href="/index.html" name="Accueil"/> + <menu name="Documentation" inherit="top"> + <item name="Présentation" href="index.html" /> + <item name="Utilisation" href="user/howto.html" /> + <item name="Génération des modèles" href="user/ModelGeneration.html"/> + <item name="Tag values" href="user/tagvalues.html" /> + <item name="TopiaQuery" href="user/TopiaQuery.html"/> + <item name="FAQ" href="user/FAQ.html"/> </menu> + <menu name="Tutoriels" inherit="top"> + <item name="Démarrer avec ToPIA et Maven" href="user/start.html" /> + <item name="Commencer à développer avec l'API ToPIA" href="user/start_using_api.html" /> + <item name="Étendre le modèle" href="user/extend_model.html" /> + <item name="Continer le développement" href="user/continue_devel.html" /> + </menu> + + <menu name="Développeurs"> + <item name="Todo" href="devel/Todo.html"/> + <item name="Mapping hibernate" href="devel/HibernateMapping.html"/> + <item name="Isolation" href="devel/Isolation.html"/> + <item name="Schema migration" href="devel/SchemaMigration.html"/> + <item name="Sécurité" href="devel/security.html"/> + <item name="TopiaContextFactory" href="devel/Devel.html"/> + <item name="Projets similaires" href="devel/project.html"/> + <item name="Gestion des évènements" href="user/event.html"/> + </menu> + <menu ref="modules"/> <menu ref="reports"/> + <links> + <item name="Nuiton.org" href="http://nuiton.org"/> + <item name="Code Lutin" href="http://www.codelutin.com"/> + <item name="Libre-Entreprise" href="http://www.libre-entreprise.org/"/> + </links> + <footer> <div id='projectMetas' locale='fr' Deleted: trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthor.png =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/ClassDiagram_BookAuthorWithOperation.png =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/ContactUseCases.png =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/ServiceCall.png =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/modelForTopiaQuery.png =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/modelForTopiaQuery.zargo =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/resources/topia.zargo =================================================================== (Binary files differ) Deleted: trunk/topia-persistence/src/site/rst/TopiaDocumentation.rst =================================================================== --- trunk/topia-persistence/src/site/rst/TopiaDocumentation.rst 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/topia-persistence/src/site/rst/TopiaDocumentation.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -1,69 +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% -.. - - -===== -ToPIA -===== - -But -=== - -- abstraction de la persistence -- sauvegarde/restauration en XML -- sécurité sur les instances d'objets -- génération de code même si non obligatoire pour utiliser ToPIA - -Ce qu'il serait bien de récuperer par rapport à la version 2 - -- support des sous-transactions - -peut-être plus tard - -- gestion des services -- distribution transparente - -La vision ToPIA -=============== - -Un point d'entre le TopiaContext sur lequel on ouvre des transactions ce qui -retourne un autre TopiaContext à partir duquel on récupère les DAO des -différentes entités qui permettent de faire les traitements que l'on souhaite. - -Ensuite on peut appeler la methode commit de ce sous TopiaContext pour mettre -à jour la base de données et permettre à d'autres TopiaContext d'avoir la -nouvelle vision de nos objets. - -Chaque TopiaContext créé sur le TopiaContext root est indépendant. - -Lorsque l'on travaille avec un objet provenant d'un TopiaContext sur lequel -on a fait un rollback, celui-ci n'est plus valide et il vaut mieux en recupérer -une version correcte sur le TopiaContext. - -Après avoir fait un commit ou un rollback sur un TopiaContext on peut continuer -a l'utiliser et refaire des commits pour synchroniser de temps en temps les -modification faites sur la base. - -Un TopiaContext peu servir aussi longtemps que l'on souhaite, il ne maintient -pas inutilement de transaction sur la base. Modified: trunk/topia-persistence/src/site/rst/index.rst =================================================================== --- trunk/topia-persistence/src/site/rst/index.rst 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/topia-persistence/src/site/rst/index.rst 2013-08-05 09:30:26 UTC (rev 2791) @@ -23,92 +23,17 @@ .. * #L% .. - -===== -ToPIA -===== +================= +ToPIA Persistence +================= -.. contents:: - Présentation ------------ -ToPIA, pour Tools for Portable and Independant Architecture, est un framework -d'abstraction des plateformes techniques. +Ce sous module de ToPIA est le module principal. -C'est à dire ? -~~~~~~~~~~~~~~ - -Le cycle de développement en Y traditionnel peut être représenté de la manière -suivante : +Il contient : + - les classes de base du framework ; + - les templates de génération ; + - ... -Les deux branches, la branche fonctionnelle, porteuse de la solution logique, et -la branche technique, qui définit la plateforme technique sur laquelle la -solution sera implantée, se rejoignent en amont de la conception détaillée et du -codage. Cette projection peut être accompagnée de génération de code, mais il -reste toujours une certaine quantité de code écrite à la main. - -Cette séparation des responsabilités et ce processsus donne pleine satisfaction -lors du développement initial d'un logiciel. La vie d'un logiciel commence -toutefois au moment de sa mise en production et les évolutions qui y seront -apportées sont de deux natures : - - Évolutions fonctionnelles : Ajout de fonctionnalités, correction de bugs, ... - - Evolutions techniques : Changement de bases de données, changement de techno - sur les UI, nouveaux accès (SOAP ?), ... - -Si les évolutions fonctionnelles sont prises en compte par la nature itérative -des processus de développement, les évolutions techniques sont elles difficiles. - -Comment passer d'hibernate à JDO, de Swing au client léger, des EJB aux -conteneurs légers ? En supprimant les dépendances de votre code sur les briques -techniques, en codant sur une plateforme technique abstraite, interfaces et -facades au travers desquels vous pourrez manipuler les différentes solutions -techniques que vous retiendrez. Hibernate et JDO ne sont que deux API d'accès -aux données; Swing et client léger, des UI; les EJB et les conteneurs légers, -des logiques métiers déportées... - -Et ToPIA alors ? -~~~~~~~~~~~~~~~~ - -ToPIA propose une telle plateforme. Vous codez en regard d'une API qui abstrait -la distribution (1-tiers ?, 2-tiers ?, 3-tiers ?, n-tiers ? quels protocoles -d'accès ?), la persistence (quelles bases bien sûr, mais également quel -framework ?, quelle API de requètage (EJB-QL, JDO-QL, ... ?), quel méchanisme -transactionnel ?), quelle UI ? Puis vous projettez votre application sur la -palteforme de votre choix. - -Fonctionnement classique ------------------------- - -Le framework ToPIA permet dans un projet de générer la partie métier de l'application, -c'est à dire les classes JAVA ainsi que le mapping Hibernate pour la persistance. -Cela représente un travail considérable en moins pour le développeur et une -flexibilité importante dans les évolutions futures de la parties métier. - -L'utilisation du framework ToPIA se découpe en plusieurs phases, elles sont -itératives : - 1. Création du diagramme de classe sur ArgoUML_ par exemple - 2. Exportation du modèle en XMI - 3. Génération des fichiers JAVA et Hibernate par Eugene_ - 4. Implentation des méthodes - -ToPIA-service -------------- - -Le framework ToPIA peut être complèté par une multitude de services. Il existe -actuellement trois : - - - `service pour la sécurité`_ : permet la gestion des authentification et des - autorisations. Il repose sur le mécanisme de JAAS. - - `service pour la gestion des mises à jour`_ : permet de mettre à jour une version - de base à partir d'un modèle versionné. - - `service de réplication`_ : permet de répliquer des données de base à base. - - ``service pour la gestion d'un historique`` : permet de conserver l'ensemble des - actions réalisées sur la base de données (**plus maintenu depuis la 2.3.3**). - - ``service pour la recherche`` : permet de rechercher un mot clé parmis les entités - de l'application. Il repose sur la librairie lucene d'apache (**plus maintenu depuis la 2.3.3**). - -.. _service pour la sécurité: ../topia-service-security -.. _service pour la gestion des mises à jour: ../topia-service-migration -.. _service de réplication: ../topia-service-replication -.. _Eugene: http://maven-site.nuiton.org/eugene/ -.. _ArgoUML: http://argouml.tigris.org/ Modified: trunk/topia-persistence/src/site/site_fr.xml =================================================================== --- trunk/topia-persistence/src/site/site_fr.xml 2013-08-05 08:49:05 UTC (rev 2790) +++ trunk/topia-persistence/src/site/site_fr.xml 2013-08-05 09:30:26 UTC (rev 2791) @@ -48,32 +48,32 @@ <menu ref="parent"/> - <menu name="Tutoriel" inherit="top"> - <item name="Démarrer avec ToPIA et Maven" href="user/start.html" /> - <item name="Commencer à développer avec l'API ToPIA" href="user/start_using_api.html" /> - <item name="Étendre le modèle" href="user/extend_model.html" /> - <item name="Continer le développement" href="user/continue_devel.html" /> - </menu> + <!--<menu name="Tutoriel" inherit="top">--> + <!--<item name="Démarrer avec ToPIA et Maven" href="../user/start.html" />--> + <!--<item name="Commencer à développer avec l'API ToPIA" href="user/start_using_api.html" />--> + <!--<item name="Étendre le modèle" href="user/extend_model.html" />--> + <!--<item name="Continer le développement" href="user/continue_devel.html" />--> + <!--</menu>--> - <menu name="Utilisateur" inherit="top"> - <item name="Presentation" href="index.html" /> - <!--item name="Utilisation" href="user/howto.html" /> - <item name="Génération des modèles" href="user/ModelGeneration.html"/> - <item name="Tag values" href="user/tagvalues.html" /--> - <item name="TopiaQuery" href="user/TopiaQuery.html"/> - <item name="FAQ" href="user/FAQ.html"/> - </menu> + <!--<menu name="Utilisateur" inherit="top">--> + <!--<item name="Presentation" href="index.html" />--> + <!--<!–item name="Utilisation" href="user/howto.html" />--> + <!--<item name="Génération des modèles" href="user/ModelGeneration.html"/>--> + <!--<item name="Tag values" href="user/tagvalues.html" /–>--> + <!--<item name="TopiaQuery" href="user/TopiaQuery.html"/>--> + <!--<item name="FAQ" href="user/FAQ.html"/>--> + <!--</menu>--> - <menu name="Developpeur"> - <item name="Todo" href="devel/Todo.html"/> - <item name="Mapping hibernate" href="devel/HibernateMapping.html"/> - <item name="Isolation" href="devel/Isolation.html"/> - <item name="Schema migration" href="devel/SchemaMigration.html"/> - <item name="Securité" href="devel/security.html"/> - <item name="TopiaContextFactory" href="devel/Devel.html"/> - <item name="Projets similaires" href="devel/project.html"/> - <item name="Gestion des evenements" href="user/event.html"/> - </menu> + <!--<menu name="Developpeur">--> + <!--<item name="Todo" href="devel/Todo.html"/>--> + <!--<item name="Mapping hibernate" href="devel/HibernateMapping.html"/>--> + <!--<item name="Isolation" href="devel/Isolation.html"/>--> + <!--<item name="Schema migration" href="devel/SchemaMigration.html"/>--> + <!--<item name="Securité" href="devel/security.html"/>--> + <!--<item name="TopiaContextFactory" href="devel/Devel.html"/>--> + <!--<item name="Projets similaires" href="devel/project.html"/>--> + <!--<item name="Gestion des evenements" href="user/event.html"/>--> + <!--</menu>--> <menu name="Téléchargement"> <item href="${repository.home.url}/org/nuiton/topia/${project.artifactId}/${project.version}/${project.build.finalName}.jar"