FAQ HibernateConsultez toutes les FAQ

Hibernate Query Langage est un langage d'interrogation des classes persistantes avec une syntaxe proche du SQL. Cependant les objets manipulés sont les classes et membres du mapping contrairement au SQL qui réalise les requêtes directement sur la base de données. Aussi, le HQL contient des fonctionnalités spécifiques au modèle objet.

Les requêtes HQL peuvent être formées des éléments principaux suivants :

les clauses (from, select, where, order by, ...)
les fonctions d'agrégation (count, sum, avg, max, ...)
les sous-requêtes (il s'agit de requêtes HQL dont le résultat est utilisé dans une requête HQL principale)

Exemple :

FROM infos.Contact contact WHERE contact.nom = 'Dupont'

Pour exécuter une requête HQL, il vous faut employer la méthode createQuery() sur votre session :

Query query = session.createQuery("Requête HQL");

Non, les requêtes HQL ne sont pas sensibles à la casse, sauf pour tout ce qui concerne le nom des classes Java et des propriétés.

Ainsi FrOm est tout à fait égal à FROM et à from. Mais from Cat n'est pas égal à from cAt.

Pour pouvoir insérer des quotes dans une requête, il suffit de doubler tous les ' dans votre requête. Par exemple :

FROM table WHERE field LIKE 'C''est'

• Voici la procédure sous Hibernate 2 : Vous pouvez directement employer next() sur le résultat de votre requête HQL pour ne pas avoir à initialiser votre collection et simplement compter le nombre de résultats en employant count(*) :
  

  Code java :

  Sélectionner tout

  ((Integer) session.iterate("select count(*) from ....").next() ).intValue();

• Voici la procédure sous Hibernate 3 :
  

  Code java :

  Sélectionner tout

  Integer count = (Integer) session.createQuery("select count(*) from ....").uniqueResult();

Il suffit d'employer la méthode setMaxResults de votre Query :

1
2
3
Query query = sess.createQuery("Votre requête HQL"); 
query.setMaxResults(10); 
List results = query.list();