2. Un premier exemple

2.1. Écriture d'une première requête

Commençons par écrire une première requête JPQL, qui cherche les marins dont le nom est Surcouf.

Exemple 29. Une première requête JPQL

select marin from Marin marin where marin.nom =  'Surcouf'

Cette requête ressemble grandement à du SQL, notons tout de même les différences suivantes :

En SQL on sélectionne une liste de colonnes appartenant à une ou plusieurs tables. En JPQL on sélectionne une entité. L'entité que l'on sélectionne, ici Marin, est désignée par son nom. Rappelons que le nom d'une entité est donné par l'attribut name de l'annotation @Entity. S'il n'est pas précisé, alors le nom par défaut de l'entité est le nom complet de la classe.
En SQL, la clause where exprime des contraintes sur les colonnes d'une des tables qui est interrogée par la requête. En JPQL elle s'exprime sur les champs de l'entité sur laquelle la sélection a lieu. L'entité Marin doit donc ici posséder un champ nom. Il est possible de naviguer au travers du graphe d'objets, par exemple marin.adresse.rue est une écriture légale en JPQL.
Notons tout de suite qu'il est possible de sélectionner une entité en relation d'une autre. Par exemple select marin.adresse from Marin marin ... retournera une liste d'objets adresse.

2.2. Exécution d'une première requête

L'exécution d'une requête passe par la création d'un objet de type Query à partir de l' entity manager .

Exemple 30. Exécution d'une première requête

// Construction d'un entity manager
EntityManager em = ... ;

 // construction d'un objet Query	
Query query = em.createQuery(
    "select marin from Marin marin where marin.nom = 'Surcouf'") ;

 // exécution et récupération de la liste résultat
List<Marin> marins = query.getResultList() ;

 // analyse du résultat (classique)
 for (Marin marin : marins) {
    System.out.println(marin.getNom()) ;
}

Exécuter une requête JPQL se fait donc en deux temps :

Définition de l'objet requête proprement dit, de type Query.
Puis exécution de la requête, et lecture du résultat.

Notons que Query possède également deux autres méthodes :

getSingleResult() : retourne l'unique objet résultat de cette requête. Si la requête retourne plusieurs objets, alors une exception de type NonUniqueResultException est générée.
getFirstResult() : retourne le premier objet résultat de cette requête. Si la requête ne retourne aucun objet, alors cette méthode renvoie null.

2.3. Exécution d'une première requête d'agrégation

De même que le SQL, le JPQL définit la notion d'agrégation. La syntaxe est analogue au SQL. Voyons un exemple qui permet d'obtenir le nom de marins dont le nom commence par un 's'.

Exemple 31. Une première requête d'agrégation

// construction d'un objet Query	
Query query = em.createQuery(
    "select count(marin) from Marin marin where marin.nom like 'S%'") ;

 // exécution et récupération du résultat
 int nombre = (Integer)query.getSingleResult() ;

Dans ce cas on peut utiliser sans crainte la méthode getSingleResult().

JPA & EJB

Retour au blog Java le soir

Cours & Tutoriaux