Author: fdesbois Date: 2010-04-29 23:56:04 +0200 (Thu, 29 Apr 2010) New Revision: 1917 Url: http://nuiton.org/repositories/revision/topia/1917 Log: Add some infos in 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-04-29 19:21:12 UTC (rev 1916) +++ trunk/topia-persistence/src/site/rst/TopiaQuery.rst 2010-04-29 21:56:04 UTC (rev 1917) @@ -137,6 +137,7 @@ - TopiaQuery.Op.LE : Opérateur <= - TopiaQuery.Op.NOT_NULL : Opérateur IS NOT NULL - TopiaQuery.Op.NULL : Opérateur IS NULL +- TopiaQuery.Op.NEQ : Opérateur != Autres parties de la requête ---------------------------- @@ -293,7 +294,7 @@ 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 +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 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 @@ -304,12 +305,17 @@ SELECT d'origine pour pouvoir être par exemple executé de façon différente par la suite. +Note + Si la requête contient un DISTINCT (via la méthode addDistinct()), le + executeCount() gèrera automatiquement la contrainte sur la requête : + "SELECT COUNT(DISTINCT B) FROM Boat B ..." + Limitation des résultats ~~~~~~~~~~~~~~~~~~~~~~~~ Il est possible de limiter le nombre de résultats lors de l'exécution pour -optimiser la requête pour une pagination par exemple. Pour ce faire il faut -utiliser les méthodes **setLimit(int start, int end)** et/ou +optimiser la requête dans le cas d'une pagination par exemple. Pour ce faire +il faut utiliser les méthodes **setLimit(int start, int end)** et/ou **setMaxResults(int max)** :: // 18 premiers résultats