Accueil › Spring Boot › Le modèle et le dépôt, premières fondations
Le modèle et le dépôt, premières fondations
Exercice de la série « Un projet de bout en bout »debutant
Le projet. La boutique veut une API de catalogue : lister ses produits, en consulter un, en créer, en corriger, en retirer, filtrer, trier, paginer. Les dix exercices de cette série construisent cette API, dans l'ordre où on la construit vraiment — et le premier jour, on n'écrit ni contrôleur ni route. On écrit ce qu'on stocke, et ce qui le stocke.
Ni Spring, ni serveur, ni base de données ne tournent ici : votre
code est compilé par javac seul, et c'est un banc d'essai Java
ordinaire — fourni, visible sous « Code fourni, déjà en place » — qui
appelle votre classe directement. 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. Le modèle, et lui seul :
record Produit(long id, String nom, String categorie, int prixCentimes, int stock)
muni de avecId(long) et avecStock(int) — qui rendent des copies —
et de resume(), qui l'affiche. Plus le banc, qui enregistre deux
produits puis joue le scénario du cas.
Ce qu'on vous demande. Écrivez la classe DepotProduit, en mémoire,
avec exactement ces cinq méthodes :
long enregistrer(Produit produit)
Optional<Produit> parId(long id)
List<Produit> tous()
boolean supprimer(long id)
int taille()
enregistrertient le rôle dusavede Spring Data, et il en a la double nature. Siproduit.id()vaut0, c'est une création : le dépôt attribue l'identifiant le plus grand déjà présent, plus un (donc1sur un dépôt vide), stocke une copie portant cet identifiant, et le rend. Siproduit.id()est non nul, c'est un remplacement : l'objet est stocké à cet identifiant, qui est rendu tel quel, et la taille du dépôt ne change pas.tous()rend les produits dans l'ordre d'insertion, et non dans un ordre quelconque.supprimerrendtruesi un produit a bien été retiré,falses'il n'y avait rien à cet identifiant.parIdrend unOptionalvide pour un identifiant absent — jamaisnull.
Pourquoi 0 pour « pas encore d'identifiant ». C'est la convention
de JPA avec un long : une entité dont la clé primitive vaut zéro est
considérée comme neuve, et save l'insère ; une clé non nulle existe
déjà, et save met à jour. La même méthode, deux comportements, décidés
par l'état de la clé — et c'est la source d'étonnement la plus courante
chez qui débute avec Spring Data.
Le piège. Le code de départ stocke les produits à l'identifiant
qu'ils portent, sans jamais en attribuer. Les deux produits créés par
le banc vont donc tous les deux à la clé 0 : le second écrase le
premier, et le dépôt contient un seul produit alors qu'on en a enregistré
deux. supprimer, lui, répond true même quand il n'a rien supprimé —
ce qui, dans deux exercices, enverra un 204 au client pour une
ressource qui n'a jamais existé.
Cas de test
essai("creation")essai("lecture")essai("remplacement")essai("suppression")
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 »
- 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
- Une page de catalogue, et ses bornes
- 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