Author: bleny Date: 2013-11-08 13:22:43 +0100 (Fri, 08 Nov 2013) New Revision: 2871 Url: http://nuiton.org/projects/topia/repository/revisions/2871 Log: add instructions to rename DAOs in topia 3.0 migration doc Modified: trunk/src/site/rst/migrate_to_3.0.rst Modified: trunk/src/site/rst/migrate_to_3.0.rst =================================================================== --- trunk/src/site/rst/migrate_to_3.0.rst 2013-11-08 12:16:32 UTC (rev 2870) +++ trunk/src/site/rst/migrate_to_3.0.rst 2013-11-08 12:22:43 UTC (rev 2871) @@ -66,12 +66,17 @@ TopiaId ------- -|RECOMMENDED| +|MANDATORY| La classe sera supprimée. Pour manipuler les topiaId, il faut utiliser le **TopiaIdFactory**. +La forme des topiaIds générés à changé. Si vous souhaitez conserver l'ancienne forme parce que vous +souhaitez conserver l'uniformité avec une base de données existante ou si vous utilisez +topia-service-security, vous devez explicitement le spécifier à Topia 3.0 via la configuration : + ``topia.persistence.topiaIdFactoryClassName=org.nuiton.topia.persistence.LegacyTopiaIdFactory`` + TopiaContextImplementor est déprécié ------------------------------------ @@ -136,7 +141,7 @@ |RECOMMENDED| -Si vous utilisiez explicitment le Transformer de DAO dans la configuration de votre plugin Eugene, il faut maintenant +Si vous utilisiez explicitement le Transformer de DAO dans la configuration de votre plugin Eugene, il faut maintenant changer le nouveau Transformer : org.nuiton.topia.generator.EntityDaoTransformer Exemple de configuration : @@ -166,10 +171,10 @@ -|RECOMMENDED| +|MANDATORY| -Si vous aviez surchargé certains des Dao générés, vous devrez probablement les renommer et changer leur signature. -Surveillez les logs de génération des Dao à la recherche des messages tels que : +Si vous aviez surchargé certains des DAO générés, vous devrez probablement les renommer et changer leur signature. +Surveillez les logs de génération des DAO à la recherche des messages tels que : :: @@ -177,20 +182,24 @@ - You should consider renaming 'org.project.entities.ZoneDAOImpl' to 'org.project.entities.AbstractZoneTopiaDao' - Expected class declaration is : public class AbstractZoneTopiaDao<E extends Zone> extends GeneratedZoneTopiaDao<E> { +Pour l'entité Zone, vous devez supprimer votre ZoneDAO et votre ZoneDAOImpl et déplacer les méthodes +* dans ZoneTopiaDao si la méthode ne peut être utilisée seulement pour l'entité Zone (et pas les sous-classes de Zone) +* dans AbstractZoneTopiaDao si la méthode peut être utilisée pour Zone ET les entités qui héritent de Zone + Méthodes findAll, find et findUnique sur TopiaContext ----------------------------------------------------- |MANDATORY| -Si vous utilisiez ces méthodes, il est désormais recommandé de les utiliser méthodes sur le Dao associé à votre éntité +Si vous utilisiez ces méthodes, il est désormais recommandé d'utiliser les méthodes sur le DAO associé à votre éntité ou par l'intermédiare du **TopiaJpaSupport**. -Depuis un Dao surchargé +Depuis un DAO surchargé ~~~~~~~~~~~~~~~~~~~~~~~ Pour faciliter la migration, ces méthodes ont été portées sur l'interface deprecated **TopiaDAO**. Donc si dans votre -Dao vous faisiez : +DAO vous faisiez : :: @@ -206,7 +215,8 @@ ~~~~~~~~~~~~~~~~~ Dans tous les cas, ces méthodes étant dépréciées, vous devriez consulter leur Javadoc pour savoir par quels appels de -méthodes les remplacer. +méthodes les remplacer. S'il n'y pas de documentation, il faut remplacer le code appellant par le corps de la méthode dépréciée +(fonctionnalité « inline » dans l'IDE).