Entitätsübersicht
Die Seite Entities Map prüft das JPA-Mapping jeder Entität einer Spring-Boot-Instanz und zeigt Beziehungen, deren Mapping zusätzliche Abfragen verursacht: Eager Fetching, List-basiertes @ManyToMany, Kaskadierung mit REMOVE oder ALL und unidirektionales @OneToMany.

Entities Map in der Axelix-Oberfläche
Fehler beim Mapping von JPA-Beziehungen führen nicht zum Ausfall der Anwendung. Stattdessen verursachen sie bei jeder Verwendung der Entität zusätzliche Abfragen und Ladevorgänge und werden bei Code-Reviews leicht übersehen. Entities Map prüft das Mapping aller Entitäten und zeigt, wo solche Fehler auftreten.
Die Seite ist schreibgeschützt und für alle authentifizierten Benutzer zugänglich: VIEWER, EDITOR, ADMIN und SUPER_ADMIN können sie öffnen. Die vollständige Rollen- und Berechtigungsmatrix finden Sie unter Rollen und Berechtigungen.
Was die Seite zeigt
Eine Zusammenfassung oben zeigt, wie viele Entitäten die Instanz abbildet, wie viele davon Probleme haben und wie viele unauffällig sind. Darunter listet die Seite die Entitäten mit Problemen auf.
Klappen Sie eine Entität auf, um Folgendes zu sehen:
- Den Tabellennamen aus
@Tableoder den Entitätsnamen, wenn@Tablekeinen Namen festlegt. - Jede problematische Beziehung, etwa
Owner.pets, mit ihren Problemen. - Das Mapping dieser Beziehung mit den tatsächlich wirksamen Werten einschließlich Standardwerten, etwa
@OneToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL) @JoinColumn(name = "owner_id") List<Pet>.
Hat keine Entität Probleme, zeigt die Seite einen entsprechenden Hinweis statt der Liste.
Erkannte Probleme
- EAGER fetching: Die Beziehung wird bei jedem Lesen der Entität geladen, unabhängig davon, ob die Daten verwendet
werden. Dies umfasst
@ManyToOneund@OneToOneohne explizitesfetch, da JPA sie standardmäßig sofort lädt. - List for @ManyToMany: Bei einer durch
Listrepräsentierten@ManyToMany-Beziehung leert Hibernate bei jeder Änderung die gesamte Zuordnungstabelle und fügt die Einträge neu ein. - Bad CascadeType: Bei
@OneToManyoder@ManyToManyführtCascadeType.REMOVEoderCascadeType.ALLdazu, dass Hibernate zugehörige Datensätze einzeln entfernt, wodurch N+1-Abfragen entstehen. - Unidirectional @OneToMany: Ein
@OneToManyohnemappedBybenötigt eine zusätzliche Zuordnungstabelle oder ein separatesUPDATEfür jeden Datensatz.
Funktionsweise
Der Axelix Spring Boot Starter liest das JPA-Metamodell der Anwendung und prüft jede Beziehung. Anders als bei Transaction Control hängt das Ergebnis nicht vom Datenverkehr ab: Axelix prüft das Mapping der Entitäten und nicht die ausgeführten Abfragen. Die Seite benötigt Hibernate in der Anwendung.
MCP-Werkzeuge
KI-Agenten können die Entitäten und ihre Mapping-Probleme über MCP abrufen, für die gesamte Anwendung oder für eine bestimmte Entität. Siehe MCP-Werkzeugkatalog.
Eigenschaften
Entities Map arbeitet mit der Transaktionsüberwachung zusammen und ist standardmäßig aktiviert. Zum Deaktivieren setzen
Sie axelix.sbs.transaction.monitoring.enabled=false. Einzelheiten finden Sie unter
Transaktionsüberwachung.
Entities Map ist in reaktiven Anwendungen (WebFlux) nicht verfügbar, weil die Transaktionsüberwachung dort nicht läuft. Siehe Reaktive Anwendungen (WebFlux).
Siehe auch
Transaktionskontrolle
Die Seite Transaction Control findet @Transactional-Methoden, die eine Datenbankverbindung länger als nötig belegen: blockierende Netzwerkaufrufe, N+1-Abfragen und Paginierung im Arbeitsspeicher innerhalb der Transaktion. Für jedes Problem zeigt sie den Ort, damit Sie die Stelle im Code finden.
Thread-Dump
Die Seite Thread Dump zeigt eine laufend aktualisierte Momentaufnahme aller Threads der verwalteten Spring Boot-Instanz. Sie fragt die Instanz regelmäßig ab, sodass Liste, Thread-Zustände und Zeitleiste den jüngsten JVM-Zustand statt einer eingefrorenen Aufnahme zeigen.