Varlık haritası
Varlık haritası sayfası, bir Spring Boot örneğindeki tüm varlıkların JPA eşlemelerini denetler ve ek sorgulara yol açan ilişkileri gösterir: eager yükleme, List tabanlı @ManyToMany, REMOVE veya ALL cascade ve tek yönlü @OneToMany.

Axelix arayüzünde Entities Map
JPA ilişki eşlemelerindeki hatalar uygulamayı bozmaz. Bunun yerine varlık her kullanıldığında ek sorgulara ve yüklemelere yol açar; kod incelemesinde de kolayca gözden kaçabilir. Varlık haritası tüm varlıkların eşlemelerini denetler ve bu tür hataların nerede olduğunu gösterir.
Sayfa salt okunurdur ve kimliği doğrulanmış tüm kullanıcılara açıktır: VIEWER, EDITOR, ADMIN ve SUPER_ADMIN sayfayı açabilir. Rol/yetki matrisinin tamamı için Roller ve yetkiler bölümüne bakın.
Sayfada gösterilenler
Üstteki özet, örneğin kaç varlık eşlediğini, kaçında sorun bulunduğunu ve kaçının sorunsuz olduğunu gösterir. Sayfanın altında sorunlu varlıklar listelenir.
Bir varlığı genişleterek şunları görebilirsiniz:
@Tableiçindeki tablo adı veya@Tablebir ad belirtmiyorsa varlığın adı.Owner.petsgibi her sorunlu ilişki ve sorunları.- Varsayılanlar dâhil geçerli değerlerle ilişkinin eşlemesi; örneğin
@OneToMany(fetch = FetchType.EAGER, cascade = CascadeType.ALL) @JoinColumn(name = "owner_id") List<Pet>.
Hiçbir varlıkta sorun yoksa sayfa liste göstermek yerine bunu belirtir.
Tespit edilen sorunlar
- EAGER fetching: İlişki, veriler kullanılsa da kullanılmasa da varlık her okunduğunda yüklenir. JPA varsayılan olarak eager yüklediğinden, açık bir
fetchbelirtmeyen@ManyToOneve@OneToOneilişkileri de buna dâhildir. - List for @ManyToMany:
Listkullanan bir@ManyToMany, herhangi bir değişiklikte Hibernate'in birleştirme tablosundaki tüm kayıtları silip yeniden eklemesine yol açar. - Bad CascadeType: Bir
@OneToManyveya@ManyToManyüzerindekiCascadeType.REMOVEya daCascadeType.ALL, Hibernate'in ilişkili kayıtları tek tek silmesine yol açarak N+1 sorgu oluşturur. - Unidirectional @OneToMany:
mappedByiçermeyen bir@OneToMany, ek bir birleştirme tablosu veya her kayıt için ayrı birUPDATEgerektirir.
Nasıl çalışır?
Axelix Spring Boot Starter, uygulamanın JPA meta modelini okur ve her ilişkiyi denetler. İşlem denetiminden farklı olarak sonuç trafiğe bağlı değildir: Axelix hangi sorguların çalıştırıldığını değil, varlıkların nasıl eşlendiğini denetler. Bu sayfa için uygulamada Hibernate bulunmalıdır.
MCP araçları
Yapay zekâ ajanları MCP aracılığıyla tüm uygulama veya tek bir varlık için varlıkları ve eşleme sorunlarını alabilir. MCP araçları kataloğuna bakın.
Özellikler
Varlık haritası işlem izlemeyle birlikte çalışır ve varsayılan olarak etkindir. Kapatmak için axelix.sbs.transaction.monitoring.enabled=false ayarını kullanın. Ayrıntılar için İşlem izleme bölümüne bakın.
İşlem izleme reaktif (WebFlux) uygulamalarda çalışmadığı için varlık haritası bu uygulamalarda kullanılamaz. Reaktif (WebFlux) uygulamalar bölümüne bakın.
Ayrıca bkz.
İşlem denetimi
İşlem denetimi sayfası, veritabanı bağlantısını gereğinden uzun süre meşgul eden @Transactional metotlarını bulur: işlem içindeki bloklayan ağ çağrıları, N+1 sorguları ve bellekte sayfalama. Her sorunun nerede gerçekleştiğini göstererek ilgili kodu bulmanızı sağlar.
İş parçacığı dökümü
İş parçacığı dökümü sayfası, yönetilen Spring Boot örneğindeki tüm iş parçacıklarının canlı bir anlık görüntüsünü gösterir. Sayfa örneği düzenli olarak sorguladığından liste, iş parçacığı durumları ve zaman çizelgesi sabit bir kayıt yerine JVM’nin yakın zamandaki durumunu yansıtır.