FAQ HibernateConsultez toutes les FAQ

Criteria est une API de recherche orientée objet. Elle permet de faire des recherches dans la base de données de manière très simple. On peut ajouter des tris, des filtres, ...

HQL a beau être très puissant, beaucoup de développeurs préfèrent avoir une approche plus orientée objet, ils trouvent donc leur bonheur dans Criteria.

Tout d'abord il vous faut une session d'ouverte pour créer la Criteria. Ensuite, Criteria étant une recherche sur une classe donnée, il vous faut connaître le nom de cette classe et finalement, vous pouvez créer la requête :

Criteria criteria = session.createCriteria(Od.class);

List results = criteria.list();

Avec Criteria, vous pouvez ajouter des restrictions qui vous permettront de limiter les résultats en fonction de différents critères.

Pour cela, nous allons ajouter des Criterions, que va nous fournir la classe restriction. Par exemple pour un like :

1
2
3
Criteria criteria = sess.createCriteria(Od.class) 
    .add(Restrictions.like("description", "Attention%"))); 
List results = criteria.list();

Vous pouvez aussi regrouper différents critères de manière logique avec les opérateurs ou et et.

Voici un exemple avec un opérateur ou :

1
2
3
4
5
6
7
Criteria criteria = session.createCriteria(Od.class) 
    .add(Restrictions.between("weigth", 100,200) ) 
    .add(Restrictions.or( 
        Restrictions.isNotNull("etiquette"), 
        Restrictions.isNull("description") 
    ) ) 
List results = criteria.list();

Une autre possibilité qui nous est donnée par Criteria est de pouvoir effectuer une recherche à partir d'un exemple.

Exemple, vous avez une classe Film avec un réalisateur et une année de sortie et vous voulez trouver tous les autres films de ce même réalisateur :

1
2
3
4
5
6
7
8
9
10
11
12
Film film = new Film(); 
film.setRealisateur("Frères Wachowsky"); 
film.setAnnee(2005); 
  
Example example = Example.create(film) 
	.excludeProperty("annee") //On ne compare pas avec l'année 
	.ignoreCase(); //On ne tient pas compte de la casse 
  
Criteria criteria = session.createCriteria(Film.class) 
	.add(example); 
  
List results = criteria.list();

Vous pouvez trier les résultats d'une requête Criteria par propriété dans l'ordre croissant ou décroissant.

Pour cela, nous allons employer la méthode addOrder sur le Criteria et la classe Order :

1
2
3
4
5
Criteria criteria = session.createCriteria(Od.class) 
    .add(Restrictions.between("weigth", 200, 500)) 
    .addOrder(Order.asc("weigth")) 
    .addOrder(Order.desc("nom")); 
List results = criteria.list();

Vous pouvez ajouter une Projection à votre Criteria :

criteria.setProjection(Projections.rowCount());

Integer result = (Integer) criteria.uniqueResult();

1
2
3
4
Criteria criteria = session.createCriteria(OdPersonne.class); 
criteria.setProjection(Projections.rowCount()); 
Integer result = (Integer) criteria.uniqueResult(); 
System.out.println("Nombre d'enregistrements : " + result);

Comme pour une requête HQL, il vous suffit d'employer la méthode setMaxResults sur votre Criteria pour que la recherche ne retourne par plus de résultats que voulu.

1
2
Criteria crit = session.createCriteria(Od.class); 
crit.setMaxResults(10);

Par défaut, cela n'est pas possible, mais il suffit tout simplement de rajouter dans un Set les éléments de la liste renvoyée par le Criteria :

1
2
HashSet set =  new HashSet(); 
set.addAll(session.createCriteria(MonOd.class).list());