Utilisation des graphes d'entités
Préalables
Nous utilisons depuis plusieurs séances les entités et leurs relations. Par commodité et pour éviter un chargement de données excessif, nous utilisons en général le chargement retardé des relations.
Ce mécanisme permet de limiter la quantité de données transmise mais il implique que la connexion vers la base soit toujours ouverte afin de récupérer, à la demande, les données manquantes. cela pose un problème dans une approche transactionnelle. Hormis cette difficulté, le chargement retardé implique le lancement de plusieurs requêtes de récupération des données annexes. Cela peut avoir un impact très fort sur l'efficacité de nos traitements.
Nous allons essayer de régler ces problèmes avec les graphes d'entités.
Ce TP est basé sur un tutoriel annexe, mais je vous demande de respecter les recommandations listées ci-dessous.
À faire :
- Reprenez le projet du TP précédent.
- créez le package myboot.app3.model : nos données.
- créez le package myboot.app3.dao : définition des dépôts.
- créez le package myboot.app3.test dans le répertoire test.
Mise en oeuvre
Travail à faire : Suivez ce tutoriel mais avec la procédure suivante :
- Placez les entités dans le package prévu.
- Ajoutez la clause suivante dans votre fichier de
configuration (application.properties) afin de
visualiser les requêtes :
spring.jpa.show-sql=true spring.jpa.properties.hibernate.format_sql=true
- Ajoutez à vos entités les constructeurs basés sur les propriétés qui permettent de créer facilement des instances (annotations @Data, @NoArgsConstructor et @AllArgsConstructor).
-
Attention : la
classe User va entrer en
conflit avec la classe XUser définie dans les TP précédents.
Ajoutez la clause ci-dessous pour régler le problème.
@Table(name = "eguser")
- Construisez les repositories pour chaque entité.
- Prévoyez un test populate exécuté en premier (voir comment faire) qui va créer en base une grande quantité d'utilisateurs, de publications et de commentaires. Il est évidemment très important que ces instances soient en liaison les unes avec les autres (plusieurs dizaines de publications par utilisateur et plusieurs dizaines de commentaires par publication). Attention : vous devrez annoter la classe de test par @Rollback(false) afin que les modifications effectuées par populate ne soient pas oubliées (car c'est la politique par défaut).
- Utilisez ces données pour tester chaque fonction proposée par le tutoriel en vérifiant les données récupérées et celles qui nécessitent une opération supplémentaire (il faut bien déterminer la frontière du graphe des données).
- Ajoutez à vos entités les relations inverses (User->Post et User->Comment) et testez le bon fonctionnement des EG. Vous pouvez notamment faire deux GE : user-with-posts et user-with-comments.
- Essayez le graphe user-with-posts-and-comments. Vous allez découvrir une limitation des graphes d'entités (plus d'information).
Après le tutoriel : G.E. et Spring Data
Vous pouvez demander à Spring Data d'utiliser les graphes d'entités en
- ajoutant une méthode annotée @Query dans vos dépôts ;
- ajoutant à cette méthode l'annotation ci-dessous.
@EntityGraph("nom-du-graphe-d-entités")
Travail à faire : Vérifiez par un test unitaire la bonne prise en compte du graphe d'entités (les données sont-elles chargées ?).
Chargement retardé avec JPAQL
Pour compléter le problème du chargement retardé, il vous est possible de demander explicitement le chargement d'une donnée au travers d'une requête JPA (clause FETCH).
En vous aidant de la requête ci-dessous, ajoutez une méthode au dépôt de gestion des publications et testez le bon chargement des commentaires (mais pas du propriétaire de la publication).
select p from Post p join fetch p.comments where (id = :id)
Performance
Vérifiez par une mesure des temps d'exécution qu'il existe une différence importante entre un chargement retardé géré de manière manuelle (appel à la méthode size() par exemple) et la solution des graphes d'entités.
Vérifiez cette différence notamment si la BD est stockée sur disque.