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.
PagingAndSortingRepositoryetJpaRepositoryacceptent unPageableen paramètre surfindAll(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) ouPageRequest.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é à unPageable.- 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êteCOUNTsupplé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êteCOUNT. 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
Pageableest résolu automatiquement depuis les paramètres de requête?page=0&size=20&sort=nom,asc(plusieurssortpossibles).pagepar défaut à0,sizepar défaut à20.- Pagination en mémoire avec JOIN FETCH
Paginer une requête qui fait un
JOIN FETCHsur 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 internePageImplde Spring Data, dont la structure JSON exacte n'est pas garantie stable dans le temps.
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.