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

r2021 - in trunk: . topia-persistence topia-persistence/src/test/resources
by fdesbois＠users.nuiton.org June 24, 2010

June 24, 2010

Author: fdesbois Date: 2010-06-24 15:59:11 +0200 (Thu, 24 Jun 2010) New Revision: 2021 Url: http://nuiton.org/repositories/revision/topia/2021 Log: Evo #704 : manage modifiers on inner classifier + add some debug log Modified: trunk/pom.xml trunk/topia-persistence/pom.xml trunk/topia-persistence/src/test/resources/log4j.properties Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2010-06-23 13:22:59 UTC (rev 2020) +++ trunk/pom.xml 2010-06-24 13:59:11 UTC (rev 2021) @@ -230,7 +230,7 @@ <projectId>topia</projectId>  - <eugene.version>2.0.2</eugene.version> + <eugene.version>2.0.3-SNAPSHOT</eugene.version> <lutinutil.version>1.3.1</lutinutil.version> <processor.version>1.0.3</processor.version> <i18n.version>1.2.2</i18n.version> Modified: trunk/topia-persistence/pom.xml =================================================================== --- trunk/topia-persistence/pom.xml 2010-06-23 13:22:59 UTC (rev 2020) +++ trunk/topia-persistence/pom.xml 2010-06-24 13:59:11 UTC (rev 2021) @@ -192,7 +192,8 @@ org.nuiton.topia.generator.EntityTransformer, org.nuiton.topia.generator.InterfaceTransformer, org.nuiton.topia.generator.BeanTransformer, - org.nuiton.topia.generator.EntityDTOTransformer + org.nuiton.topia.generator.EntityDTOTransformer, + org.nuiton.topia.generator.QueryHelperTransformer </templates> <excludeTemplates> <excludeTemplate>org.nuiton.topia.generator.EntityAbstractTransformer</excludeTemplate> Modified: trunk/topia-persistence/src/test/resources/log4j.properties =================================================================== --- trunk/topia-persistence/src/test/resources/log4j.properties 2010-06-23 13:22:59 UTC (rev 2020) +++ trunk/topia-persistence/src/test/resources/log4j.properties 2010-06-24 13:59:11 UTC (rev 2021) @@ -10,3 +10,4 @@ log4j.logger.org.nuiton.topia=INFO #log4j.logger.org.nuiton.topiatest=DEBUG log4j.logger.org.nuiton.topia.persistence.util=INFO +log4j.logger.org.nuiton.topia.generator=DEBUG

1 0

r2020 - trunk/topia-persistence/src/main/java/org/nuiton/topia/generator
by fdesbois＠users.nuiton.org June 23, 2010

June 23, 2010

Author: fdesbois Date: 2010-06-23 15:22:59 +0200 (Wed, 23 Jun 2010) New Revision: 2020 Url: http://nuiton.org/repositories/revision/topia/2020 Log: Deprecate BeanTransformer, prefer using JavaBeanTransformer from EUGene Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/generator/BeanTransformer.java Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/generator/BeanTransformer.java =================================================================== --- trunk/topia-persistence/src/main/java/org/nuiton/topia/generator/BeanTransformer.java 2010-06-19 18:57:34 UTC (rev 2019) +++ trunk/topia-persistence/src/main/java/org/nuiton/topia/generator/BeanTransformer.java 2010-06-23 13:22:59 UTC (rev 2020) @@ -29,6 +29,7 @@ import org.apache.commons.logging.Log; import org.apache.commons.logging.LogFactory; import org.nuiton.eugene.GeneratorUtil; +import org.nuiton.eugene.java.JavaBeanTransformer; import org.nuiton.eugene.java.ObjectModelTransformerToJava; import org.nuiton.eugene.models.object.ObjectModelAttribute; import org.nuiton.eugene.models.object.ObjectModelClass; @@ -56,7 +57,9 @@ * @author tchemit <tchemit(a)codelutin.com> * @version $Id$ * @plexus.component role="org.nuiton.eugene.Template" role-hint="org.nuiton.topia.generator.BeanTransformer" + * @deprecated since 2.3.5 use {@link JavaBeanTransformer} instead */ +@Deprecated public class BeanTransformer extends ObjectModelTransformerToJava { private static final Log log = LogFactory.getLog(BeanTransformer.class);

1 0

r2019 - trunk
by tchemit＠users.nuiton.org June 19, 2010

June 19, 2010

Author: tchemit Date: 2010-06-19 20:57:34 +0200 (Sat, 19 Jun 2010) New Revision: 2019 Url: http://nuiton.org/repositories/revision/topia/2019 Log: Utilisation de mavenpom4redmine 2.2 Modified: trunk/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2010-06-15 15:07:57 UTC (rev 2018) +++ trunk/pom.xml 2010-06-19 18:57:34 UTC (rev 2019) @@ -33,7 +33,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>mavenpom4redmine</artifactId> - <version>2.1.5</version> + <version>2.2</version> </parent> <artifactId>topia</artifactId> @@ -313,4 +313,53 @@ <url>http://www.nuiton.org/repositories/browse/topia/trunk</url> </scm> + <profiles> + + <profile> + <id>central-safe</id> + <activation> + <property> + <name>performRelease</name> + <value>true</value> + </property> + </activation> + + <properties> + +  + <release.repository>${nuiton.central.release.repository}</release.repository> + + </properties> + + <build> + <defaultGoal>validate</defaultGoal> + <plugins> + <plugin> + <groupId>org.nuiton</groupId> + <artifactId>maven-helper-plugin</artifactId> + <executions> + <execution> + <id>check-central-safe</id> + <inherited>true</inherited> + <goals> + <goal>check-auto-container</goal> + </goals> + <configuration> + <addMavenCentral>true</addMavenCentral> + <failIfNotSafe>true</failIfNotSafe> + <repositories> + <nuiton-central-releases> + http://nexus.nuiton.org/nexus/content/repositories/nuiton-central-releases + </nuiton-central-releases> + </repositories> + </configuration> + </execution> + </executions> + </plugin> + </plugins> + </build> + </profile> + + </profiles> + </project>

1 0

r2018 - trunk/topia-persistence/src/main/java/org/nuiton/topia/framework
by fdesbois＠users.nuiton.org June 15, 2010

June 15, 2010

Author: fdesbois Date: 2010-06-15 17:07:57 +0200 (Tue, 15 Jun 2010) New Revision: 2018 Url: http://nuiton.org/repositories/revision/topia/2018 Log: [TopiaQuery] Improve addFetch javadoc Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java =================================================================== --- trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-15 08:24:25 UTC (rev 2017) +++ trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-15 15:07:57 UTC (rev 2018) @@ -617,18 +617,22 @@ /** * Used to load properties during query execution using FETCH keyword. This * keyword is used in a JOIN, so the alias is needed to identify properties - * to load. If no mainAlias is defined in the query, all properties will - * automatically have a generated alias to identify them. Also an empty - * SELECT statement will be defined to retrieve the correct entity depends - * on the mainEntity type in the query. Carefull using addFetch, hibernate - * doesn't support more than 3 or 4 join. In this case, you can use {@link - * #addLoad(String...)} or load manually the entities wanted. + * to load. + * </p> + * Also an empty SELECT statement will be defined to retrieve the correct + * entity depends on the mainEntity type in the query. Carefull using + * addFetch, hibernate doesn't support more than 3 or 4 join. In this case, + * you can use {@link #addLoad(String...)} or load manually the entities + * wanted. * * @param properties Properties to load during query execution * @return the TopiaQuery */ public TopiaQuery addFetch(String... properties) { + // Note : creating alias is not very efficient if other parameters is needed + // Maybe the solution is to throw an exception if no mainAlias is defined + // Check mainAlias, necessary to use join fetch boolean needAlias = false; if (StringUtils.isEmpty(mainAlias)) {

1 0

r2017 - in trunk: . topia-persistence topia-service-migration topia-service-replication topia-service-security
by fdesbois＠users.nuiton.org June 15, 2010

June 15, 2010

Author: fdesbois Date: 2010-06-15 10:24:25 +0200 (Tue, 15 Jun 2010) New Revision: 2017 Url: http://nuiton.org/repositories/revision/topia/2017 Log: [maven-release-plugin] prepare for next development iteration Modified: trunk/pom.xml trunk/topia-persistence/pom.xml trunk/topia-service-migration/pom.xml trunk/topia-service-replication/pom.xml trunk/topia-service-security/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2010-06-15 08:24:20 UTC (rev 2016) +++ trunk/pom.xml 2010-06-15 08:24:25 UTC (rev 2017) @@ -37,7 +37,7 @@ </parent> <artifactId>topia</artifactId> - <version>2.3.4</version> + <version>2.3.5-SNAPSHOT</version> <modules> <module>topia-persistence</module> @@ -307,10 +307,10 @@  <scm> - <connection>scm:svn:http://svn.nuiton.org/svn/topia/tags/topia-2.3.4</connection> - <developerConnection>scm:svn:http://svn.nuiton.org/svn/topia/tags/topia-2.3.4 + <connection>scm:svn:http://svn.nuiton.org/svn/topia/trunk</connection> + <developerConnection>scm:svn:http://svn.nuiton.org/svn/topia/trunk </developerConnection> - <url>http://www.nuiton.org/repositories/browse/topia/tags/topia-2.3.4</url> + <url>http://www.nuiton.org/repositories/browse/topia/trunk</url> </scm> </project> Modified: trunk/topia-persistence/pom.xml =================================================================== --- trunk/topia-persistence/pom.xml 2010-06-15 08:24:20 UTC (rev 2016) +++ trunk/topia-persistence/pom.xml 2010-06-15 08:24:25 UTC (rev 2017) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.3.4</version> + <version>2.3.5-SNAPSHOT</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-migration/pom.xml =================================================================== --- trunk/topia-service-migration/pom.xml 2010-06-15 08:24:20 UTC (rev 2016) +++ trunk/topia-service-migration/pom.xml 2010-06-15 08:24:25 UTC (rev 2017) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.3.4</version> + <version>2.3.5-SNAPSHOT</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-replication/pom.xml =================================================================== --- trunk/topia-service-replication/pom.xml 2010-06-15 08:24:20 UTC (rev 2016) +++ trunk/topia-service-replication/pom.xml 2010-06-15 08:24:25 UTC (rev 2017) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.3.4</version> + <version>2.3.5-SNAPSHOT</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-security/pom.xml =================================================================== --- trunk/topia-service-security/pom.xml 2010-06-15 08:24:20 UTC (rev 2016) +++ trunk/topia-service-security/pom.xml 2010-06-15 08:24:25 UTC (rev 2017) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.3.4</version> + <version>2.3.5-SNAPSHOT</version> </parent> <groupId>org.nuiton.topia</groupId>

1 0

r2016 - in tags: . topia-2.3.4
by fdesbois＠users.nuiton.org June 15, 2010

June 15, 2010

Author: fdesbois Date: 2010-06-15 10:24:20 +0200 (Tue, 15 Jun 2010) New Revision: 2016 Url: http://nuiton.org/repositories/revision/topia/2016 Log: [maven-release-plugin] copy for tag topia-2.3.4 Added: tags/topia-2.3.4/ Property changes on: tags/topia-2.3.4 ___________________________________________________________________ Added: svn:ignore + *.ipr *.iws .classpath *.iml .project target .settings Added: svn:mergeinfo + /branches/from2.2.2-eugene2-beta:1662-1714

1 0

r2015 - in trunk: . topia-persistence topia-service-migration topia-service-replication topia-service-security
by fdesbois＠users.nuiton.org June 15, 2010

June 15, 2010

Author: fdesbois Date: 2010-06-15 10:24:18 +0200 (Tue, 15 Jun 2010) New Revision: 2015 Url: http://nuiton.org/repositories/revision/topia/2015 Log: [maven-release-plugin] prepare release topia-2.3.4 Modified: trunk/pom.xml trunk/topia-persistence/pom.xml trunk/topia-service-migration/pom.xml trunk/topia-service-replication/pom.xml trunk/topia-service-security/pom.xml Modified: trunk/pom.xml =================================================================== --- trunk/pom.xml 2010-06-14 22:38:21 UTC (rev 2014) +++ trunk/pom.xml 2010-06-15 08:24:18 UTC (rev 2015) @@ -37,7 +37,7 @@ </parent> <artifactId>topia</artifactId> - <version>2.4-SNAPSHOT</version> + <version>2.3.4</version> <modules> <module>topia-persistence</module> @@ -307,10 +307,10 @@  <scm> - <connection>scm:svn:http://svn.nuiton.org/svn/topia/trunk</connection> - <developerConnection>scm:svn:http://svn.nuiton.org/svn/topia/trunk + <connection>scm:svn:http://svn.nuiton.org/svn/topia/tags/topia-2.3.4</connection> + <developerConnection>scm:svn:http://svn.nuiton.org/svn/topia/tags/topia-2.3.4 </developerConnection> - <url>http://www.nuiton.org/repositories/browse/topia/trunk</url> + <url>http://www.nuiton.org/repositories/browse/topia/tags/topia-2.3.4</url> </scm> </project> Modified: trunk/topia-persistence/pom.xml =================================================================== --- trunk/topia-persistence/pom.xml 2010-06-14 22:38:21 UTC (rev 2014) +++ trunk/topia-persistence/pom.xml 2010-06-15 08:24:18 UTC (rev 2015) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.4-SNAPSHOT</version> + <version>2.3.4</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-migration/pom.xml =================================================================== --- trunk/topia-service-migration/pom.xml 2010-06-14 22:38:21 UTC (rev 2014) +++ trunk/topia-service-migration/pom.xml 2010-06-15 08:24:18 UTC (rev 2015) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.4-SNAPSHOT</version> + <version>2.3.4</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-replication/pom.xml =================================================================== --- trunk/topia-service-replication/pom.xml 2010-06-14 22:38:21 UTC (rev 2014) +++ trunk/topia-service-replication/pom.xml 2010-06-15 08:24:18 UTC (rev 2015) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.4-SNAPSHOT</version> + <version>2.3.4</version> </parent> <groupId>org.nuiton.topia</groupId> Modified: trunk/topia-service-security/pom.xml =================================================================== --- trunk/topia-service-security/pom.xml 2010-06-14 22:38:21 UTC (rev 2014) +++ trunk/topia-service-security/pom.xml 2010-06-15 08:24:18 UTC (rev 2015) @@ -35,7 +35,7 @@ <parent> <groupId>org.nuiton</groupId> <artifactId>topia</artifactId> - <version>2.4-SNAPSHOT</version> + <version>2.3.4</version> </parent> <groupId>org.nuiton.topia</groupId>

1 0

r2014 - trunk/topia-persistence/src/site/rst
by fdesbois＠users.nuiton.org June 14, 2010

June 14, 2010

Author: fdesbois Date: 2010-06-15 00:38:21 +0200 (Tue, 15 Jun 2010) New Revision: 2014 Url: http://nuiton.org/repositories/revision/topia/2014 Log: Update TopiaQuery documentation Modified: trunk/topia-persistence/src/site/rst/TopiaQuery.rst Modified: trunk/topia-persistence/src/site/rst/TopiaQuery.rst =================================================================== --- trunk/topia-persistence/src/site/rst/TopiaQuery.rst 2010-06-14 21:50:20 UTC (rev 2013) +++ trunk/topia-persistence/src/site/rst/TopiaQuery.rst 2010-06-14 22:38:21 UTC (rev 2014) @@ -68,7 +68,7 @@ BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); TopiaQuery query = dao.createQuery(); -ou Depuis un topiaContext :: +ou depuis un topiaContext :: TopiaContext transaction = rootContext.beginTransaction(); TopiaQuery query = transaction.createQuery(Boat.class, "B"); @@ -76,7 +76,7 @@ L'intérêt de passer par un DAO est de pouvoir par la suite executer la requête avec ce même DAO. Il est également possible d'utiliser des alias pour l'élément principal de la requête pour pouvoir plus facilement gérer les cas de jointure. -Il suffit de préciser l'alias au moment de l'instantiation :: +Il suffit de préciser l'alias au moment de l'instanciation :: TopiaContext transaction = rootContext.beginTransaction(); BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); @@ -85,7 +85,7 @@ Ajout d'éléments au WHERE ------------------------- -Les méthodes de base nécessaire concerne l'ajout d'élements dans le WHERE de la +Les méthodes de base nécessaires concernent l'ajout d'élements dans le WHERE de la requête. Plusieurs méthodes sont disponibles suivant les besoins pour ajouter simplement un élément au where :: @@ -295,6 +295,15 @@ } // Utilisation de la première requête comme sous-requête + query2.add("C2." + Contact.CREATION_DATE + " = (" + query1.fullQuery() + ")"); + // Ajout des paramètres nécessaires de la première requête dans la deuxième + query2.addParams(query1.getParams()); + +Depuis la 2.3.4, la méthode **addSubQuery(String statement, TopiaQuery subquery)** +permet de faciliter l'injection d'une sous-requête notamment pour la gestion +des paramètres automatiquement (avec prise en charge des doublons) :: + + // Même chose que précédemment en utilisant la méthode addSubQuery query2.addSubQuery("C2." + Contact.CREATION_DATE + " = (?)", query1); La requête sous forme HQL :: @@ -317,9 +326,8 @@ --------- Plusieurs méthodes sont disponibles pour récupérer les résultats de la requête. -Pour chaque méthode, il est possible de l'appeler avec en paramètre le contexte -topia ou directement, si la requête a été instancié avec un DAO qui contient -lui même le contexte. La méthode de base est la méthode execute() qui renvoie +Pour chaque méthode, il est nécessaire de l'appeler avec le contexte +topia. La méthode de base est la méthode execute() qui renvoie une liste non typé à l'instar de la méthode find(...) du TopiaContext. Il est cependant possible de récupérer directement un objet, un entier (pour un aggregat par exemple) ou une chaîne de caractères suivant le select de la @@ -349,17 +357,60 @@ // résultats du 50ème au 60ème query.setLimit(49, 59); +// depuis 2.3.4 + +Pour éviter d'embarquer ces paramètres à chaque fois qu'ils sont nécessaires +lors d'un filtrage paginée, un bean, *EntityFilter* est disponible. +Il contient les attributs suivants : + +- startIndex : index de début des résultats. + +- endIndex : index de fin des résultats. + +- orderBy : propriétés à ordonner (l'ajout des mots clés 'asc' et 'desc' est + possible). + +- referenceId : identifiant d'une référence utile à la requête. + +- referenceProperty : nom de la propriété correspondant à la valeur du referenceId. + +Exemple : Nous souhaitons les contacts 30 à 60 triés par 'creationDate' décroissant et +'personName' croissant pour un navire donné par son topiaId :: + + EntityFilter filter = new EntityFilter(); + filter.setStartIndex(30); + filter.setEndIndex(60); + filter.setOrderBy("creationDate desc, personName"); + filter.setReferenceId(boat.getTopiaId()); + // ou filter.setReference(boat); + filter.setReferenceProperty("boat"); + + TopiaQuery query = contactDAO.createQuery().addFilter(filter); + +L'intérêt de l'EntityFilter est de pouvoir l'instancier et le manipuler directement +depuis votre interface (Swing, Web, ...) et de l'utiliser sur une requête métier. +La méthode **addFilter(EntityFilter filter)** permettra d'injecter les paramètres +s'ils possèdent une valeur. + +Note + L'ordre définit par défaut est celui de création par ordre décroissant : + *topiaCreateDate desc*. + Utilisation des DAO ~~~~~~~~~~~~~~~~~~~ Les DAO fournissent également quelques méthodes permettant de récupérer plus facilement les résultats avec le type souhaité : +- **countByQuery(TopiaQuery query)** : compte le nombre de résultats de la + requête. +- **existByQuery(TopiaQuery query)** : renvoie vrai si la requête à retourner + au moins 1 résultat. - **findByQuery(TopiaQuery query)** : renvoie une entité (un seul résultat) - **findAllByQuery(TopiaQuery query)** : renvoie une liste d'entités - **findAllMappedByQuery(TopiaQuery query)** : renvoie une map d'entités avec pour clé le topiaId de l'entité. -- **findAllMappedByQuery(TopiaQuery, Class keyClass, String keyProperty)** : +- **findAllMappedByQuery(TopiaQuery query, Class keyClass, String keyProperty)** : renvoie une map d'entités avec pour clé la propriété passée en argument. Exemple :: @@ -368,6 +419,13 @@ BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); TopiaQuery query = dao.createQuery(); ... + // pour vérifier l'existance de résultat + boolean hasResult = dao.existByQuery(query); + + // pour savoir le nombre de résultats + int count = dao.countByQuery(query); + + // pour récupérer les résultats Map<String, Boat> boatMap = dao.findAllMappedByQuery(query); // ou List<Boat> boatList = dao.findAllByQuery(query); @@ -377,14 +435,16 @@ Map<Integer, Boat> boatMapImma = dao.findAllMappedByQuery(query, Integer.class, Boat.IMMATRICULATION); + Résultats complexes ~~~~~~~~~~~~~~~~~~~ Certains cas de requête peuvent avoir des résultats plus complexes, notamment -lorsqu'il s'agit de propriété de différentes entités ou avec des aggrégats ( -AVG, SUM, COUNT). Dans ce cas il faut utiliser la méthode de base **execute()** -qui renvoie une liste non typée. Lorsqu'il y a plus d'un élément dans le select -la liste renvoyée est une List<Object[]>, le tableau pour chaque ligne +lorsqu'il s'agit de propriétés de différentes entités ou avec l'utilisation d' +aggrégats (AVG, SUM, COUNT). Dans ce cas il faut utiliser la méthode de base +**findByQuery(TopiaQuery query)** depuis une transaction +qui renverra une liste non typée. Lorsqu'il y a plus d'un élément dans le +select la liste renvoyée est une List<Object[]>, le tableau pour chaque ligne correspondant aux valeurs des résultats. Exemple :: TopiaContext transaction = rootContext.beginTransaction(); @@ -394,7 +454,7 @@ TopiaQuery query = dao.createQuery(). setSelect(boatImma, "COUNT(*)").addGroup(boatImma); - List<Object[]> results = query.execute(); + List<Object[]> results = transaction.findByQuery(query); // Parcours des résultats for (Object[] result : results) { Integer immatriculation = (Integer)result[0]; @@ -407,8 +467,8 @@ Chargement des donnees ---------------------- -Généralement une fois la requête exécuté, la transaction utilisé est directement -fermé (topiaContext.closeContext()). Dans ce cas, il est souvent nécessaire de +Généralement une fois la requête exécutée, la transaction utilisée est directement +fermée (topiaContext.closeContext()). Dans ce cas, il est souvent nécessaire de charger certaines entités pour éviter les malencontreuses LazyException d'Hibernate. Plusieurs possibilités s'offrent à vous : @@ -422,6 +482,8 @@ myapp.entity.Contact.attribute.boat.tagvalue.lazy=false +(*myapp.entity.Contact* étant le nom qualifié de la classe Contact) + Ainsi chaque contact récupéré aura automatiquement son navire associé de chargé. **Attention** cependant, il ne faut pas abuser du tagvalue *lazy* car sinon Hibernate @@ -447,7 +509,7 @@ modèle d'exemple, il est possible de charger le navire associé aux contacts en utilisant : queryContact.addLoad(Contact.BOAT); -Dans le cas du addLoad, plusieurs requêtes seront exécutés suivant le nombre +Dans le cas du addLoad, plusieurs requêtes seront exécutées suivant le nombre de Contact résultats. Il est dans ce cas plus judicieux d'utiliser le addFetch qui chargera directement les Boat au moment de la récupération des Contact : queryContact.addFetch(Contact.BOAT); L'alias peut s'avérer indispensable pour @@ -474,8 +536,8 @@ - Si addLoad non utilisable (trop de chargement de collections) : effectuer un chargement manuelle en parcourant les résultats. Pour le chargement d'une entité simple, il suffit d'utiliser le getter correspondant pour la charger, - tandis que pour une collection, l'appel à la méthode size permet de charger - l'intégralité des éléments. + tandis que pour une collection, l'appel à la méthode size associée permet de + charger l'intégralité des éléments.

1 0

r2013 - in trunk/topia-persistence/src: main/java/org/nuiton/topia/framework site/rst
by fdesbois＠users.nuiton.org June 14, 2010

June 14, 2010

Author: fdesbois Date: 2010-06-14 23:50:20 +0200 (Mon, 14 Jun 2010) New Revision: 2013 Url: http://nuiton.org/repositories/revision/topia/2013 Log: Update TopiaQuery documentation Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java trunk/topia-persistence/src/site/rst/TopiaQuery.rst Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java =================================================================== --- trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-14 14:21:58 UTC (rev 2012) +++ trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-14 21:50:20 UTC (rev 2013) @@ -615,10 +615,17 @@ } /** - * TODO-fdesbois-2010-06-02 : javadoc + * Used to load properties during query execution using FETCH keyword. This + * keyword is used in a JOIN, so the alias is needed to identify properties + * to load. If no mainAlias is defined in the query, all properties will + * automatically have a generated alias to identify them. Also an empty + * SELECT statement will be defined to retrieve the correct entity depends + * on the mainEntity type in the query. Carefull using addFetch, hibernate + * doesn't support more than 3 or 4 join. In this case, you can use {@link + * #addLoad(String...)} or load manually the entities wanted. * - * @param properties - * @return + * @param properties Properties to load during query execution + * @return the TopiaQuery */ public TopiaQuery addFetch(String... properties) { @@ -673,7 +680,7 @@ } /** - * @param where + * @param where Where statement to add * @return TopiaQuery * @deprecated since 2.3.4, use {@link #addWhere(String)} instead */ @@ -712,9 +719,9 @@ } /** - * @param paramName - * @param constraint - * @param paramValue + * @param paramName name of the parameter to add + * @param constraint constraint to use + * @param paramValue value of this parameter * @return TopiaQuery * @deprecated since 2.3.4, use {@link #addWhere(String, Op, Object)} instead */ @@ -771,8 +778,8 @@ } /** - * @param paramName - * @param paramValue + * @param paramName name of the parameter to add + * @param paramValue value of this parameter * @return TopiaQuery * @since 2.3.1 * @deprecated since 2.3.4, use {@link #addEquals(String, Object...)} instead @@ -847,7 +854,7 @@ } /** - * @param properties + * @param properties map of the properties to add * @return TopiaQuery * @deprecated since 2.3.4 use {@link #addEquals(Map)} */ Modified: trunk/topia-persistence/src/site/rst/TopiaQuery.rst =================================================================== --- trunk/topia-persistence/src/site/rst/TopiaQuery.rst 2010-06-14 14:21:58 UTC (rev 2012) +++ trunk/topia-persistence/src/site/rst/TopiaQuery.rst 2010-06-14 21:50:20 UTC (rev 2013) @@ -62,25 +62,22 @@ Il y a plusieurs façons d'instancier la TopiaQuery : -Directement en connaissant la classe de l'entité :: - - TopiaQuery query = new TopiaQuery(Boat.class); - Directement depuis un DAO :: TopiaContext transaction = rootContext.beginTransaction(); BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); TopiaQuery query = dao.createQuery(); +ou Depuis un topiaContext :: + + TopiaContext transaction = rootContext.beginTransaction(); + TopiaQuery query = transaction.createQuery(Boat.class, "B"); + L'intérêt de passer par un DAO est de pouvoir par la suite executer la requête avec ce même DAO. Il est également possible d'utiliser des alias pour l'élément principal de la requête pour pouvoir plus facilement gérer les cas de jointure. Il suffit de préciser l'alias au moment de l'instantiation :: - TopiaQuery query = new TopiaQuery(Boat.class, "E"); - -ou :: - TopiaContext transaction = rootContext.beginTransaction(); BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); TopiaQuery query = dao.createQuery("E"); @@ -95,24 +92,40 @@ TopiaQuery query = boatDAO.createQuery(); // Recherche sur l'immatriculation du navire : immatriculation = 142154 - query.add("immatriculation", 142154); + query.addEquals("immatriculation", 142154); // Recherche toutes les dates de construction < 2006 - query.add("buildYear", Op.LT, 2006); + query.addWhere("buildYear", Op.LT, 2006); // Recherche des navires ayant un nom query.addNotNull("name"); + // depuis 2.3.4 // Recherche des navires n'ayant pas de nom - query.add("name", Op.EQ, null); + query.addNull("name"); // Recherche des navires ayant une date de construction 2003, 2004 ou 2006 - query.add("buildYear", 2003, 2004, 2006); + query.addEquals("buildYear", 2003, 2004, 2006); + // depuis 2.3.4 + // Recherche entre deux dates + TopiaQuery queryContact = contactDAO.createQuery(); + Calendar dateBegin = new GregorianCalendar(2010,2,3); + Calendar dateEnd = new GregorianCalendar(2010,5,6); + queryContact.addBetween("creationDate", dateBegin.getTime(), dateEnd.getTime()); + + // depuis 2.3.4 + // Utilisation d'une sous-requête (les paramètres de la sous-requête seront + // ajoutés automatiquement à la requête principale en gérant les doublons + // (sur la valeur et la clé)). + // Le ? correspond à l'endroit ou sera injecté la requête, attention aux + // parenthèses. + queryContact.addSubQuery("boat IN elements(?)", query); + Il est fortement conseillé d'utiliser les constantes des entités pour les noms de leurs propriétés :: - query.add(Boat.IMMATRICULATION, 142154); + query.addEquals(Boat.IMMATRICULATION, 142154); query.addNotNull(Boat.NAME); ... @@ -121,7 +134,7 @@ TopiaContext transaction = rootContext.beginTransaction(); BoatDAO dao = ModelDAOHelper.getBoatDAO(transaction); - dao.createQuery().add(Boat.IMMATRICULATION, 142154).addNotNull(Boat.NAME); + dao.createQuery().addEquals(Boat.IMMATRICULATION, 142154).addNotNull(Boat.NAME); Opérateurs ---------- @@ -146,11 +159,8 @@ ~~~~~~~~~~~~~~~~~~~~~~~ Il est souvent nécessaire d'ajouter une autre entité au FROM de la requête, -pour ce faire, il existe trois méthodes : +pour ce faire, il existe deux méthodes : -- addFrom(String str) : ajoute l'élément souhaité au FROM - (Ex : addFrom(Contact.class.getName() + " C");) - - addFrom(Class entityClass) : ajoute une entité au FROM (Ex : addFrom(Contact.class);) @@ -160,6 +170,22 @@ C'est généralement la dernière méthode qui sera la plus utilisé, l'utilisation des alias facilitant grandement les liaisons entre les entités. +Depuis la 2.3.4, deux méthodes ont été rajoutés pour le cas des jointures : + +- addJoin(Class entityClass, String alias, boolean fetch) : utilise un inner + join pour lier une entité à celle de la requête. Concrètement l'opérateur + JOIN Hql sera utilisé : 'FROM Contact C JOIN C.boat' :: + + TopiaContext transaction = rootContext.beginTransaction(); + ContactDAO dao = ModelDAOHelper.getBoatDAO(transaction); + TopiaQuery query = dao.createQuery("C").addJoin("C.boat", null, false); + +- addLeftJoin(Class entityClass, String alias, boolean fetch) : même chose que + le addJoin sauf que l'opérateur LEFT JOIN Hql sera utilisé. + + +Voir le `Chargement des donnees` pour l'utilisation du fetch. + Ajout d'élément au SELECT ~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -232,7 +258,7 @@ Il peut être également utile d'utiliser une TopiaQuery comme sous-requête d'une autre. De plus certains mots clés comme EXISTS ou encore l'utilisation de méthode HQL ne possèdent pas leurs propres méthodes. Vous pouvez cependant -utiliser la méthode de base **add(String str)** qui permet l'ajout au WHERE +utiliser la méthode de base **addWhere(String str)** qui permet l'ajout au WHERE directement (avec ajout automatique des parenthèses). Dans ce cas, il est souvent nécessaire d'ajouter des paramètres HQL à la requête (:monParam) qui devront être ajouté à la TopiaQuery en utilisant la méthode @@ -243,7 +269,7 @@ Date beginDate = ... Date endDate = ... TopiaQuery query1 = dao.createQuery("C"). - add("C." + Contact.VALIDATION + " IS NOT NULL OR " + + addWhere("C." + Contact.VALIDATION + " IS NOT NULL OR " + "C." + Contact.CREATION_DATE + " BETWEEN :begin AND :end"). addParam("begin", beginDate).addParam("end", endDate); @@ -261,17 +287,15 @@ // sélection spécifique pour un navire if (immatriculation != null) { - query2.add("C2." + Contact.BOAT + "." + Boat.IMMATRICULATION, + query2.addEquals("C2." + Contact.BOAT + "." + Boat.IMMATRICULATION, immatriculation); // Ajout d'une condition sur le navire dans la première requête - query1.add("C." + Contact.BOAT + " = C2." + Contact.BOAT); + query1.addWhere("C." + Contact.BOAT + " = C2." + Contact.BOAT); } // Utilisation de la première requête comme sous-requête - query2.add("C2." + Contact.CREATION_DATE + " = (" + query1.fullQuery() + ")"); - // Ajout des paramètres nécessaires de la première requête dans la deuxième - query2.addParams(query1.getParams()); + query2.addSubQuery("C2." + Contact.CREATION_DATE + " = (?)", query1); La requête sous forme HQL :: @@ -283,10 +307,10 @@ AND C.boat = C2.boat); Attention - Il ne faut pas utiliser la méthode add(String str, Object value) pour + Il ne faut pas utiliser la méthode addEquals(String str, Object value) pour une comparaison entre deux propriétés comme précédemment : - *query1.add("C." + Contact.BOAT + " = C2." + Contact.BOAT)*. - L'appel *query1.add("C." + Contact.BOAT, "C2." + Contact.BOAT)* ne + *query1.addWhere("C." + Contact.BOAT + " = C2." + Contact.BOAT)*. + L'appel *query1.addEquals("C." + Contact.BOAT, "C2." + Contact.BOAT)* ne fonctionnera pas comme souhaité. Résultats @@ -380,4 +404,78 @@ Note Les aggrégats renvoient principalement un type Long et non Integer. +Chargement des donnees +---------------------- +Généralement une fois la requête exécuté, la transaction utilisé est directement +fermé (topiaContext.closeContext()). Dans ce cas, il est souvent nécessaire de +charger certaines entités pour éviter les malencontreuses LazyException d'Hibernate. +Plusieurs possibilités s'offrent à vous : + +Chargement automatique +~~~~~~~~~~~~~~~~~~~~~~ + +Hibernate permet de déclarer explicitement que certaines relations doivent se +charger dès la récupération des entités. Il faut pour cela utiliser le tagValue +*lazy* dans le fichier de properties du modèle. Par exemple pour charger +le navire associé à chaque contact récupéré via une requête, il faut préciser :: + + myapp.entity.Contact.attribute.boat.tagvalue.lazy=false + +Ainsi chaque contact récupéré aura automatiquement son navire associé de chargé. + +**Attention** cependant, il ne faut pas abuser du tagvalue *lazy* car sinon Hibernate +risque de charger une bonne partie de votre base de données à chaque fois, ce qui +peut s'avérer extrêment coûteux. Cette utilisation doit être limitée au cas d'une +simple association comme c'est ici le cas, le Boat chargé étant **indispensable** +à l'utilisation du Contact. + +Chargement manuelle +~~~~~~~~~~~~~~~~~~~ + +La TopiaQuery fournit deux méthodes intéressantes pour le chargement manuelle : + + - addLoad(String...) : permet de charger les relations une fois la requête + exécutée. + + - addFetch(String...) : permet de charger les relations directement au moment + de la requête en utilisant une jointure et le mot clé 'FETCH' Hql. + +Le addLoad est pour le moment limité à des relations unitaires (autant que votre +modèle vous le permet, ex : entityA.entityB.entityC) ou à une seule relation +multiple directe ou indirecte (entityA.entitiesB). Si nous prenons le cas du +modèle d'exemple, il est possible de charger le navire associé aux contacts en +utilisant : queryContact.addLoad(Contact.BOAT); + +Dans le cas du addLoad, plusieurs requêtes seront exécutés suivant le nombre +de Contact résultats. Il est dans ce cas plus judicieux d'utiliser le addFetch +qui chargera directement les Boat au moment de la récupération des Contact : +queryContact.addFetch(Contact.BOAT); L'alias peut s'avérer indispensable pour +l'utilisation du addFetch, voir la javadoc pour l'utilisation des arguments. + +Note + Les méthodes de jointures permettent de faire un fetch directement : + addJoin(String property, String alias, boolean fetch); + Voir la partie de la documentation concernant le FROM de la requête. + +Attention + Hibernate ne supporte pas plus de 3 ou 4 jointures suivant leurs complexités ! + Il est donc important de limiter l'utilisation des fetch aux cas simples. + +Que choisir ? +~~~~~~~~~~~~~ + +- Relation unitaire (N-1) obligatoire : utiliser le tagValue *lazy* + +- Requête relativement simple (moins de deux jointures) : utiliser le addFetch + +- Requête complexe : utiliser le addLoad + +- Si addLoad non utilisable (trop de chargement de collections) : effectuer un + chargement manuelle en parcourant les résultats. Pour le chargement d'une + entité simple, il suffit d'utiliser le getter correspondant pour la charger, + tandis que pour une collection, l'appel à la méthode size permet de charger + l'intégralité des éléments. + + +

1 0

r2012 - trunk/topia-persistence/src/main/java/org/nuiton/topia/framework
by fdesbois＠users.nuiton.org June 14, 2010

June 14, 2010

Author: fdesbois Date: 2010-06-14 16:21:58 +0200 (Mon, 14 Jun 2010) New Revision: 2012 Url: http://nuiton.org/repositories/revision/topia/2012 Log: - Manage case of alias null Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java Modified: trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java =================================================================== --- trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-14 09:13:07 UTC (rev 2011) +++ trunk/topia-persistence/src/main/java/org/nuiton/topia/framework/TopiaQuery.java 2010-06-14 14:21:58 UTC (rev 2012) @@ -384,7 +384,7 @@ * @return the TopiaQuery */ public TopiaQuery setFrom(Class<? extends TopiaEntity> mainEntityClass) { - from = new StringBuilder(" FROM ").append(mainEntityClass.getName()); + setFrom(mainEntityClass, null); return this; } @@ -398,9 +398,11 @@ */ public TopiaQuery setFrom(Class<? extends TopiaEntity> mainEntityClass, String alias) { - setFrom(mainEntityClass); + from = new StringBuilder(" FROM ").append(mainEntityClass.getName()); mainAlias = alias; - from.append(' ').append(alias); + if (StringUtils.isNotEmpty(mainAlias)) { + from.append(' ').append(alias); + } return this; }

1 0