Carte des entités
La page Carte des entités vérifie le mapping JPA de chaque entité d’une instance Spring Boot et montre les associations dont le mapping entraîne des requêtes supplémentaires : chargement eager, @ManyToMany reposant sur une List, cascade REMOVE ou ALL et @OneToMany unidirectionnel.

Carte des entités dans l’interface Axelix
Les erreurs de mapping des associations JPA ne font pas échouer l’application. Elles entraînent plutôt des requêtes et des chargements supplémentaires à chaque utilisation de l’entité, et passent facilement inaperçues lors d’une revue de code. La Carte des entités vérifie le mapping de toutes les entités et indique où se trouvent ces erreurs.
La page est en lecture seule et accessible à tous les utilisateurs authentifiés : VIEWER, EDITOR, ADMIN et SUPER_ADMIN peuvent tous l’ouvrir. Consultez Rôles et autorités pour obtenir la matrice complète des rôles et autorités.
Contenu de la page
Un résumé en haut indique combien d’entités l’instance mappe, combien présentent des problèmes et combien n’en présentent pas. En dessous, la page répertorie les entités présentant des problèmes.
Ouvrez une entité pour voir :
- Le nom de table issu de
@Table, ou le nom de l’entité lorsque@Tablen’en définit pas. - Chaque association problématique, par exemple
Owner.pets, avec ses problèmes. - Le mapping de cette association avec les valeurs effectives, y compris les valeurs par défaut, par exemple
@OneToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL) @JoinColumn(name = "owner_id") List<Pet>.
Lorsqu’aucune entité ne présente de problème, la page l’indique au lieu d’afficher la liste.
Problèmes détectés
- Chargement EAGER : l’association est chargée à chaque lecture de l’entité, que les données soient utilisées ou
non. Cela inclut
@ManyToOneet@OneToOnesansfetchexplicite, car JPA les rend eager par défaut. - List pour @ManyToMany : une relation
@ManyToManyreposant sur uneListamène Hibernate à vider et à réinsérer toute la table de jointure à chaque modification. - CascadeType incorrect : sur une relation
@OneToManyou@ManyToMany,CascadeType.REMOVEouCascadeType.ALLamène Hibernate à supprimer les enregistrements associés un par un, ce qui produit des requêtes N+1. - @OneToMany unidirectionnel : une relation
@OneToManysansmappedBynécessite une table de jointure supplémentaire ou une instructionUPDATEdistincte pour chaque enregistrement.
Fonctionnement
L’Axelix Spring Boot Starter lit le métamodèle JPA de l’application et vérifie chaque association. Contrairement à Contrôle des transactions, le résultat ne dépend pas du trafic : Axelix vérifie le mapping des entités, et non les requêtes exécutées. Hibernate doit être présent dans l’application pour que la page fonctionne.
Outils MCP
Les agents IA peuvent obtenir les entités et leurs problèmes de mapping via MCP, pour toute l’application ou pour une entité. Consultez le catalogue des outils MCP.
Propriétés
La Carte des entités fonctionne avec la surveillance des transactions et est activée par défaut. Pour la désactiver,
définissez axelix.sbs.transaction.monitoring.enabled=false. Consultez Surveillance des
transactions
pour plus de détails.
La Carte des entités n’est pas disponible dans les applications réactives (WebFlux), car la surveillance des transactions ne fonctionne pas dans celles-ci. Consultez Applications réactives (WebFlux).
Voir aussi
Contrôle des transactions
La page Contrôle des transactions repère les méthodes @Transactional qui monopolisent une connexion à la base de données plus longtemps que nécessaire : appels réseau bloquants, requêtes N+1 et pagination en mémoire dans la transaction. Pour chaque problème, elle indique où il se produit afin que vous puissiez retrouver l’endroit dans le code.
Dump des threads
La page Thread Dump présente un instantané en direct de tous les threads de l’instance Spring Boot gérée. La page interroge périodiquement l’instance : la liste, les états des threads et la chronologie reflètent donc l’état récent de la JVM, plutôt qu’une capture figée.