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 :
le catalogue, 47 produits nommés
produit-01àproduit-47; la catégorie estcuisinepour les numéros pairs etbureaupour les impairs ; le prix est100 × numérocentimes et le stock le numéro lui-même ;le service, avec
tous()etparCategorie(String);et la forme de la réponse, à remplir :
record PageProduits(List<String> contenu, int page, int taille, long total, int totalPages, boolean derniere)
Ce qu'on vous demande. Ajoutez deux paramètres à votre route
GET /produits, et rendez une PageProduits en corps d'un 200 :
page, unint, par défaut0— la première page porte le numéro zéro, comme chez Spring ;taille, unint, par défaut10.
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.
pagestrictement négative → clépage, messagene doit pas etre negatif;tailleinférieure ou égale à zéro → clétaille, messagedoit etre strictement positif;triinconnu → clétri, messagevaleur inconnue : <reçu>.
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 :
- page complète :
page=3,taille=10→ les produits 31 à 40,derniereàfalse; - dernière page incomplète :
page=4,taille=10→ les produits 41 à 47, soit sept éléments, etderniereàtrue; - page au-delà du total :
page=5→200, un contenu vide, et pourtanttotalà 47 ettotalPagesà 5. Ce n'est pas une erreur : la page demandée existe comme coordonnée, elle est simplement vide. Surtout, pas d'exception : découper une liste de 47 éléments à partir du cinquantième est le plantage classique de cet exercice ; - filtrage et pagination ensemble :
categorie=cuisine&taille=5→totalà 23, et non 47.
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
essai("/produits")essai("/produits?page=3")essai("/produits?page=4")essai("/produits?page=5")essai("/produits?page=2&taille=20")essai("/produits?categorie=cuisine&taille=5")
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 »
- Le modèle et le dépôt, premières fondations
- Lister, consulter, et le 404 qui n'est pas celui du routeur
- Créer une ressource, et dire où elle est
- Refuser une entrée, et nommer le champ fautif
- Remplacer, modifier, supprimer — et rejouer deux fois
- Filtrer et trier, sans casser l'URL de la liste
- Les erreurs, traitées en un seul endroit
- Protéger les écritures, devant le contrôleur
- Une commande qui touche deux agrégats, et reste cohérente