Formations — 1 037 leçons en français

Accueil › Spring Boot › Une page de catalogue, et ses bornes

Une page de catalogue, et ses bornes

Exercice de la série « Un projet de bout en bout »intermediaire

Où l'on en est. Votre route GET /produits filtre par catégorie et trie — c'est le code de départ, repris de l'exercice 6. Le catalogue compte maintenant 47 produits, et une interface qui les affiche tous d'un coup est lente à charger, illisible, et sans espoir le jour où il y en aura cinq mille. Un client demande la page 3. Il faut la lui rendre, et lui dire combien il y en a.

Ni Spring, ni serveur, ni base de données ne tournent ici : votre code est compilé par javac seul, et c'est un routeur miniature fourni — visible sous « Code fourni, déjà en place » — qui relit par réflexion les annotations que vous avez posées, apparie le chemin, découpe la chaîne de requête, convertit chaque paramètre vers le type que votre méthode déclare — un int reste un int —, et appelle votre méthode. Monter le projet, le pom.xml, le application.yml et le démarrage ne s'apprennent pas ici : ils restent dans les leçons, et c'est leur place.

Ce que le code fourni vous donne, en plus du prélude de l'exercice 6 :

Ce qu'on vous demande. Ajoutez deux paramètres à votre route GET /produits, et rendez une PageProduits en corps d'un 200 :

Le contenu de la réponse, champ par champ :

champ ce qu'il vaut
contenu les noms des produits de la tranche demandée, dans l'ordre du tri
page, taille ce qui a été demandé, tel quel
total le nombre de produits après filtrage et avant découpe
totalPages le nombre de pages entières nécessaires pour tout montrer
derniere true s'il n'y a plus rien après cette page

Le filtrage par categorie et le tri par tri continuent de s'appliquer, avec les mêmes valeurs par défaut et le même refus d'un tri inconnu qu'à l'exercice 6.

Les contrôles, et ils se cumulent dans un seul corps — même forme qu'à l'exercice 4 : 400, et une Map<String, String> par champ fautif.

Une requête qui cumule deux fautes rend les deux entrées. Et comme à l'exercice 6, le refus précède toute lecture.

Les bornes, annoncées une par une — ce sont elles qui font échouer les paginations écrites vite :

Pourquoi total est indispensable. Sans lui, le client ne peut rien afficher d'autre qu'un bouton « suivant » qu'il clique jusqu'à tomber sur du vide. Avec lui, il dessine « page 4 sur 5 », saute à la dernière, calcule une barre de progression. C'est la raison pour laquelle Page de Spring porte getTotalElements() — au prix d'un second SELECT COUNT(*), ce qui est un compromis assumé et non un oubli.

Le piège. Le code de départ découpe la liste sans regarder où elle s'arrête : la dernière page lève une exception, et la page au-delà aussi. Il annonce par ailleurs un total égal au nombre d'éléments de la page — donc 10, toujours —, un totalPages à zéro, et derniere à false quoi qu'il arrive. Un client qui lui fait confiance tourne en rond jusqu'au plantage.

Cas de test

Écrire le code et le faire exécuter →

Votre code est réellement compilé par javac et exécuté sur une JVM — aucun JDK à installer —, et la correction compare son résultat à celui d'une solution de référence.

La leçon qui prépare cet exercice

Les autres exercices de « Un projet de bout en bout »