Accueil › Spring Boot › Le dépôt qui lit le nom de sa méthode
Le dépôt qui lit le nom de sa méthode
Exercice de la série « Ce qui fait que Spring paraît magique »avance
Le mystère le plus durable de Spring Data. On déclare une interface,
on n'écrit aucune implémentation, et findByVilleAndActif(ville, actif)
fonctionne. Il n'y a là ni intuition ni magie : au démarrage, Spring Data
découpe le nom de la méthode et en construit une requête. C'est ce
découpage que vous écrivez aujourd'hui, et c'est tout l'exercice.
Ni Spring, ni serveur, ni base de données ne tournent ici : votre code
est compilé par javac seul, et Spring n'est pas sur son classpath. Votre
moteur remplace le PartTree de Spring Data — la classe qui, dans le
vrai framework, lit ce nom et en tire du JPQL. Vous l'appliquerez à une
liste en mémoire plutôt qu'à une base : le découpage est identique, et
c'est lui qu'on apprend.
Ce que le code fourni vous donne (bloc « Code fourni, déjà en
place ») : le record Client(String nom, String ville, boolean actif), une
liste fixe de cinq clients, et le banc d'essai qui vous passe un nom de
méthode et ses arguments.
Ce qu'on vous demande. Écrivez la classe MoteurDerive avec :
static List<String> executer(String nomMethode, List<Client> clients, List<Object> arguments)
Elle rend les noms des clients retenus, dans l'ordre où votre moteur les a produits.
La grammaire à reconnaître, celle de Spring Data, dans cet ordre :
find [Top<N> | First<N>] By <Critères> [OrderBy<Champ>(Asc|Desc)]
find— le préfixe. Autre préfixe :IllegalArgumentException.Top3,First2— une limite.Firstseul (sans chiffre) vaut 1. Absents : aucune limite.<Critères>— un ou plusieurs noms de champs, reliés parAndouOr. Les champs reconnus sontNom,VilleetActif; un autre nom lèveIllegalArgumentException. Chaque critère consomme un argument de la liste, dans l'ordre.OrderBy<Champ>Asc/OrderBy<Champ>Desc— un tri sur la représentation textuelle du champ.
Un seul connecteur par nom de méthode : And et Or mélangés lèvent
IllegalArgumentException. Le vrai Spring Data accepte le mélange et
en délègue la priorité à JPQL ; refuser vaut mieux que mentir sur une
priorité, et la solution dit pourquoi.
Un piège qui vous attend, et il est à lui seul instructif. OrderBy
commence par Or. Si vous découpez les critères avant d'avoir mis le
tri de côté, findByVilleOrderByNomDesc devient « Ville Or derByNomDesc »
— deux critères là où il n'y en a qu'un. L'ordre des opérations dans
votre analyseur n'est pas un détail de style.
Le piège du code de départ. Il fait déjà le plus visible : il trouve
By, découpe les critères, filtre. Mais il traite Or comme And, et il
jette purement et simplement le tri et la limite. Résultat : les cas
simples passent, et cinq cas sur sept rendent la mauvaise liste — dans
le mauvais ordre, trop longue, ou vide. C'est exactement ce que donne un
analyseur écrit « au plus pressé ».
Cas de test
essai("findByVilleAndActif", List.<Object>of("Lyon", true))essai("findByActif", List.<Object>of(false))essai("findByVilleOrderByNomDesc", List.<Object>of("Lyon"))essai("findTop2ByActifOrderByNomAsc", List.<Object>of(true))essai("findByNomOrVille", List.<Object>of("eve", "Nantes"))essai("findFirstByVilleOrderByNomAsc", List.<Object>of("Lyon"))
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.