Formations — 1 037 leçons en français

Accueil › Spring Boot › Pagination et tri

Pagination et tri

JPA avancéintermediaire

Pageable décrit une page demandée (numéro, taille, tri). JpaRepository l'accepte directement :

public interface ProduitRepository extends JpaRepository<Produit, Long> {
    Page<Produit> findByCategorie(String categorie, Pageable pageable);
}
Pageable pageable = PageRequest.of(0, 20, Sort.by("nom").ascending()); // page 0, 20 éléments, triés par nom
Page<Produit> page = produitRepository.findByCategorie("Jardin", pageable);

page.getContent();       // les produits de cette page
page.getTotalElements(); // nombre total de produits pour ce critère
page.getTotalPages();
page.hasNext();

Dans un contrôleur Spring MVC, un paramètre Pageable est résolu automatiquement depuis les paramètres de requête HTTP :

@GetMapping("/produits")
public Page<Produit> lister(Pageable pageable) { // ?page=0&size=20&sort=nom,asc
    return produitRepository.findAll(pageable);
}

Page<T> connaît le total (une requête COUNT en plus). Slice<T> ne le connaît pas mais évite cette requête supplémentaire — un bon choix pour un simple « charger plus » sans afficher le nombre total de résultats.

Deux points de vigilance à ce niveau : paginer une requête avec JOIN FETCH sur une collection est risqué (pagination en mémoire, voir plus bas), et exposer directement une Page en JSON dans une API n'est pas recommandé — mieux vaut passer par un DTO de page.

Les termes à connaître

Pageable

Interface qui décrit une page demandée : numéro de page, taille, et tri éventuel. PagingAndSortingRepository et JpaRepository acceptent un Pageable en paramètre sur findAll(Pageable) et sur la plupart des requêtes dérivées ou @Query.

PageRequest.of(...)

Implémentation courante de Pageable. PageRequest.of(page, size) (page indexée à partir de 0) ou PageRequest.of(page, size, sort) pour ajouter un tri.

Sort

Décrit un ou plusieurs critères de tri : Sort.by("nom").ascending(), combinable avec .and(Sort.by("prix").descending()). Se passe seul (findAll(Sort)) ou intégré à un Pageable.

Page<T>

Résultat de pagination qui connaît le nombre total d'éléments et de pages (getTotalElements(), getTotalPages()), au prix d'une requête COUNT supplémentaire exécutée par Spring Data en plus de la requête de données.

Slice<T>

Résultat de pagination plus léger que Page<T> : il sait seulement s'il existe une page suivante (hasNext()), sans requête COUNT. Utile quand le total exact n'est pas nécessaire (défilement « charger plus », par exemple).

Paramètres web de pagination

Dans un contrôleur Spring MVC, un paramètre de type Pageable est résolu automatiquement depuis les paramètres de requête ?page=0&size=20&sort=nom,asc (plusieurs sort possibles). page par défaut à 0, size par défaut à 20.

Pagination en mémoire avec JOIN FETCH

Paginer une requête qui fait un JOIN FETCH sur une collection (@OneToMany) est risqué : la jointure duplique une ligne par élément de la collection, ce qui fausse la pagination SQL. Hibernate applique alors la pagination en mémoire, en chargeant beaucoup plus de données que nécessaire, avec un avertissement dans les logs.

DTO de page

Objet propre à l'API qui reprend le contenu et les métadonnées d'une Page (contenu, page courante, taille, total) sans exposer directement la classe interne PageImpl de Spring Data, dont la structure JSON exacte n'est pas garantie stable dans le temps.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.