Hibernate EHCache – Hibernate Second Level Cache

Giriş

Modern web uygulamalarında performans, kullanıcı deneyimi ve sistem kaynaklarının verimli kullanımı açısından kritik bir öneme sahiptir. Veritabanı işlemleri genellikle bir uygulamanın en yavaş bileşenlerinden biridir ve bu işlemlerin sıkça tekrarlanması performansı ciddi şekilde olumsuz etkileyebilir. Bu noktada önbellekleme (caching) devreye girer. Önbellekleme, sıkça erişilen verileri daha hızlı bir depolama alanında (bellekte) tutarak, her seferinde veritabanına gitme ihtiyacını ortadan kaldıran veya azaltan bir tekniktir.

Hibernate, Java dünyasının en popüler ORM (Object-Relational Mapping) araçlarından biridir ve veritabanı işlemlerini soyutlayarak geliştiricilere büyük kolaylık sağlar. Hibernate, performansı artırmak için güçlü bir önbellekleme mekanizması sunar. Bu mekanizma iki ana seviyeden oluşur: Birinci Seviye Önbellek (First-Level Cache) ve İkinci Seviye Önbellek (Second-Level Cache). Bu rehberde, özellikle Hibernate’in İkinci Seviye Önbelleği’ni ve bu önbelleği yönetmek için sıklıkla tercih edilen EHCache kütüphanesini detaylı bir şekilde inceleyeceğiz.

Hibernate İkinci Seviye Önbellek: Temeller ve Faydaları

Hibernate, veritabanı etkileşimlerini optimize etmek için iki seviyeli bir önbellek yapısı kullanır:

Birinci Seviye Önbellek (First-Level Cache)

Her Session nesnesine özeldir ve varsayılan olarak etkindir. Bir oturum boyunca yüklenen veya kaydedilen tüm nesneler bu önbellekte tutulur. Aynı oturum içinde aynı nesneye tekrar erişildiğinde, veritabanına gitmek yerine doğrudan bu önbellekten alınır. Bu önbellek, oturum kapandığında temizlenir ve oturumlar arasında paylaşılmaz.

İkinci Seviye Önbellek (Second-Level Cache)

SessionFactory seviyesinde çalışır ve tüm oturumlar (Session’lar) arasında paylaşılır. Birinci seviye önbelleğin aksine, İkinci Seviye Önbellek kalıcıdır ve birden fazla oturum tarafından kullanılabilir. Bir nesne bir oturum tarafından yüklendiğinde, önce Birinci Seviye Önbelleğe, ardından İkinci Seviye Önbelleğe eklenir. Başka bir oturum aynı nesneyi istediğinde, önce kendi Birinci Seviye Önbelleğine bakar, yoksa İkinci Seviye Önbelleğe bakar. Eğer orada bulursa, veritabanına gitmeden nesneyi döndürür.

İkinci Seviye Önbelleğin Faydaları:

* Veritabanı Yükünü Azaltma: Sıkça erişilen veriler için veritabanına yapılan sorgu sayısını önemli ölçüde azaltır.
* Performans Artışı: Verilerin bellekten okunması, veritabanından okunmasından çok daha hızlıdır. Bu da uygulama yanıt sürelerini iyileştirir.
* Ölçeklenebilirlik: Veritabanı üzerindeki baskıyı azaltarak uygulamanın daha fazla kullanıcıyı veya işlemi desteklemesine olanak tanır.

İkinci Seviye Önbelleğin Sakıncaları/Dikkat Edilmesi Gerekenler:

* Veri Tutarlılığı: Önbellekteki verilerle veritabanındaki verilerin senkronizasyonu önemlidir. Veritabanındaki bir değişiklik önbelleğe yansıtılmazsa, “stale data” (eskimiş veri) sorunları ortaya çıkabilir. Hibernate’in önbellek stratejileri bu sorunu yönetmeye yardımcı olur.
* Bellek Tüketimi: Çok fazla veri önbelleğe alınırsa, bellek tüketimi artabilir ve bu da uygulamanın performansını olumsuz etkileyebilir. Doğru boyutlandırma ve yaşlandırma stratejileri kritik öneme sahiptir.
* Dağıtık Ortamlar: Birden fazla uygulama sunucusunun olduğu dağıtık sistemlerde, her sunucunun kendi önbelleği bağımsız çalışırsa tutarsızlıklar yaşanabilir. Bu tür senaryolarda dağıtık önbellek çözümleri (örneğin Terracotta ile EHCache) veya diğer dağıtık önbellek sağlayıcıları (Redis, Infinispan) gereklidir.

EHCache: Hibernate ile Neden ve Nasıl Kullanılır?

EHCache, Java tabanlı uygulamalar için popüler, açık kaynaklı, yüksek performanslı ve sağlam bir önbellekleme kütüphanesidir. Hibernate’in İkinci Seviye Önbelleği için en sık tercih edilen sağlayıcılardan biridir.

EHCache’in Tercih Edilme Nedenleri:

* Kolay Entegrasyon: Hibernate ile sorunsuz bir şekilde entegre olur.
* Zengin Özellik Seti: Bellek içi (in-memory), disk tabanlı (disk-based) önbellekleme, önbellek yaşlandırma (eviction) algoritmaları (LRU, LFU, FIFO), önbellek istatistikleri ve dağıtık önbellekleme yetenekleri sunar.
* Performans: Yüksek performanslı ve düşük gecikmeli önbellek işlemleri sağlar.
* Geniş Kullanım Alanı: Sadece Hibernate ile değil, genel amaçlı bir önbellek çözümü olarak da yaygın şekilde kullanılır.
* Olgunluk ve Topluluk Desteği: Uzun yıllardır geliştirilmekte olan olgun bir projedir ve geniş bir geliştirici topluluğuna sahiptir.

Hibernate ve EHCache Entegrasyonu: Adım Adım Yapılandırma

Hibernate’ın İkinci Seviye Önbelleğini EHCache ile kullanmak için aşağıdaki adımları izlememiz gerekir:

Adım 1: Bağımlılıkları Ekleme

Projenizin pom.xml (Maven) veya build.gradle (Gradle) dosyasına gerekli bağımlılıkları ekleyin. Hibernate 5 ve sonrası için hibernate-jcache ve ehcache bağımlılıkları genellikle yeterlidir. JCache (JSR-107) standardı üzerinden EHCache’i kullanmak en modern yaklaşımdır.

    
    
        org.hibernate
        hibernate-core
        5.6.15.Final 
    

    
    
        org.hibernate
        hibernate-jcache
        5.6.15.Final
    

    
    
        org.ehcache
        ehcache
        3.10.8 
    

    
    
        org.slf4j
        slf4j-simple
        1.7.36
        runtime
    

    
    
        com.h2database
        h2
        2.2.224
    

Adım 2: Hibernate Yapılandırması

hibernate.cfg.xml veya Spring Boot kullanıyorsanız application.properties/application.yml dosyanızda Hibernate’in İkinci Seviye Önbelleğini ve EHCache’i etkinleştirin.

    
        
        org.h2.Driver
        jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1
        sa
        
        org.hibernate.dialect.H2Dialect

        
        true
        
        
        org.hibernate.cache.jcache.JCacheRegionFactory
        
        
        classpath:/ehcache.xml

        
        true

        
        update
        true
        true

        
        
    

Spring Boot application.properties örneği:

spring.jpa.properties.hibernate.cache.use_second_level_cache=true
spring.jpa.properties.hibernate.cache.region.factory_class=org.hibernate.cache.jcache.JCacheRegionFactory
spring.jpa.properties.hibernate.javax.cache.uri=classpath:/ehcache.xml
spring.jpa.properties.hibernate.cache.use_query_cache=true

Adım 3: EHCache Yapılandırması

src/main/resources dizinine ehcache.xml adında bir dosya oluşturun ve önbelleklerinizi yapılandırın.

    
        
    

    
    
        
            3600 
        
        
            1000 
             
             
        
    

    
    
        
            1800 
        
        
            500 
        
    

    
    
    
        
            900 
        
        
            200
        
    

    
    
        
            600 
        
        
            100
        
    

    
    
        
            300 
        
        
            500
        
    

* cache-template: Ortak ayarları tanımlamak için şablonlar oluşturmanıza olanak tanır.
* cache alias: Önbellekleri belirli Hibernate varlıkları, koleksiyonları veya sorgu önbelleği için adlandırmanızı sağlar. Varlıklar için tam nitelikli sınıf adını kullanın.
* expiry: Önbellek girişlerinin ne kadar süreyle geçerli olacağını tanımlar (ttl – time to live).
* resources: Önbelleğin kullanacağı kaynakları belirtir (heap belleği, disk vb.).

Adım 4: Varlıkların ve Koleksiyonların Önbelleğe Alınması

Önbelleğe almak istediğiniz Hibernate varlık sınıflarını ve koleksiyonları @Cache anotasyonu ile işaretleyin.

// Product.java
package com.example.entity;

import org.hibernate.annotations.Cache;
import org.hibernate.annotations.CacheConcurrencyStrategy;

import javax.persistence.*;
import java.util.HashSet;
import java.util.Set;

@Entity
@Table(name = "products")
// Bu varlığı İkinci Seviye Önbelleğe al
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE) // Varlık için önbellek stratejisi
public class Product {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private double price;

    @OneToMany(mappedBy = "product", cascade = CascadeType.ALL, orphanRemoval = true)
    // Koleksiyonu İkinci Seviye Önbelleğe al
    @Cache(usage = CacheConcurrencyStrategy.READ_WRITE) // Koleksiyon için önbellek stratejisi
    private Set reviews = new HashSet<>();

    // Getter ve Setter'lar
    // ...
}

Önbellek Stratejileri (CacheConcurrencyStrategy):

* READ_ONLY: Veriler asla değişmeyecekse kullanılır. En yüksek performanslı seçenektir. (Örn: Sabit kategoriler, ülkeler)
* NONSTRICT_READ_WRITE: Verilerin nadiren değiştiği durumlarda kullanılır. Bazı durumlarda tutarsız veri okumalarına yol açabilir. Genellikle tavsiye edilmez.
* READ_WRITE: Verilerin sıkça değişebileceği durumlarda kullanılır. Önbellek girişlerini güncellemelerden sonra geçersiz kılar. En yaygın kullanılan stratejidir.
* TRANSACTIONAL: JTA (Java Transaction API) ortamlarında kullanılır ve önbelleği veritabanı işlemleriyle senkronize eder. En güvenli ancak en yavaş stratejidir.

Adım 5: Sorgu Önbelleği (Query Cache)

Sıkça tekrarlanan ve aynı parametrelerle çağrılan sorguların sonuçlarını önbelleğe almak için Sorgu Önbelleği kullanılabilir. Sorgu önbelleği, sorgunun kendisini ve bu sorgunun döndürdüğü varlıkların kimliklerini (ID’lerini) saklar. Varlıkların kendileri yine İkinci Seviye Önbellekten alınır.

// Sorgu önbelleğini kullanma örneği
Session session = sessionFactory.openSession();
Transaction tx = null;
try {
    tx = session.beginTransaction();

    // Sorguyu önbelleğe al
    List products = session.createQuery("FROM Product p WHERE p.price > :minPrice", Product.class)
            .setParameter("minPrice", 50.0)
            .setCacheable(true) // Bu sorgunun sonucunu önbelleğe al
            .list();

    // ...

    tx.commit();
} catch (Exception e) {
    if (tx != null) tx.rollback();
    e.printStackTrace();
} finally {
    session.close();
}

Önemli Not: Sorgu önbelleği, sorgu sonuçlarını (yani varlık ID’lerini) önbelleğe alır. Bu ID’lere karşılık gelen varlıklar, eğer önbelleğe alınmışlarsa, İkinci Seviye Önbellekten gelir. Eğer sorgunun döndürdüğü varlıklar @Cache ile işaretlenmemişse, her seferinde veritabanından çekilecektir.

Optimizasyon ve Dikkat Edilmesi Gerekenler

Hibernate ve EHCache ile önbellekleme yaparken performansı artırmak ve olası sorunları önlemek için bazı ipuçları:

* Doğru Önbellek Stratejisi Seçimi: Verinizin değişim sıklığına göre en uygun @CacheConcurrencyStrategy‘yi seçmek çok önemlidir. READ_ONLY en hızlıdır, ancak veri değişirse tutarsızlığa yol açar. READ_WRITE çoğu senaryo için iyi bir denge sunar.
* EHCache Yapılandırmasını İyi Ayarlayın:
* expiry (TTL/TTI): timeToLiveSeconds (TTL) bir öğenin önbellekte kalabileceği maksimum süredir. timeToIdleSeconds (TTI) bir öğenin son erişiminden sonra ne kadar süreyle önbellekte kalabileceğini belirler. Uygulamanızın veri değişim sıklığına göre bu değerleri optimize edin.
* resources (Heap/Offheap/Disk): heap (bellek içi) en hızlıdır. Bellek sınırlarınıza dikkat edin. Büyük veri kümeleri için offheap veya disk seçenekleri kullanılabilir, ancak bunlar performansta bir miktar düşüşe neden olabilir.
* Önbellek Boyutları: maxEntriesLocalHeap gibi ayarlar, önbelleğin bellekte tutacağı maksimum öğe sayısını belirler. Çok küçükse önbellek isabet oranı düşük olur, çok büyükse bellek tüketimi artar. Uygulamanızın profilini çıkararak optimum değerleri bulun.
* Veri Tutarlılığı ve Dağıtık Ortamlar: Tek bir uygulama örneği için EHCache sorunsuz çalışır. Ancak birden fazla uygulama sunucusu kullanıyorsanız, her sunucunun kendi bağımsız önbelleği olacaktır. Bir sunucudaki değişiklik diğer sunucuların önbelleğini geçersiz kılmaz, bu da “stale data” sorunlarına yol açar. Bu durumda:
* Dağıtık EHCache: Terracotta ile EHCache’in dağıtık sürümünü kullanabilirsiniz.
* Harici Dağıtık Önbellekler: Redis, Infinispan, Hazelcast gibi dağıtık önbellek çözümlerini Hibernate’in JCache entegrasyonu üzerinden kullanabilirsiniz. Bu, daha karmaşık bir yapılandırma gerektirse de, veri tutarlılığını garanti eder.
* Performans İzleme: EHCache, JMX (Java Management Extensions) üzerinden önbellek istatistikleri (isabetler, kaçırmalar, öğe sayıları vb.) sunar. Bu istatistikleri izleyerek önbellek yapılandırmanızın etkinliğini değerlendirin ve ayarlamalar yapın.
* Ne Zaman Önbellekleme Yapmalı, Ne Zaman Yapmamalı:
* Yapmalı: Sıkça okunan, nadiren yazılan (yüksek okuma/yazma oranı) veriler için idealdir. (Örn: Ürün katalogları, kullanıcı profilleri, ayar parametreleri)
* Yapmamalı: Çok sık değişen veriler (önbellek geçersizleştirme maliyeti yüksek olur), çok büyük ve nadiren erişilen veriler (bellek israfı), veya güvenlik açısından hassas, her zaman güncel olması gereken veriler (örn: bankacılık işlemleri).
* Test Etme: Önbellekleme konfigürasyonunuzu, performans testleri ve yük testleri ile dikkatlice test edin. Beklenmedik davranışları veya performans sorunlarını erken aşamada tespit edin.

Sonuç ve Sıkça Sorulan Sorular (SSS)

Hibernate’ın İkinci Seviye Önbelleği ve EHCache entegrasyonu, veritabanı tabanlı uygulamaların performansını ve ölçeklenebilirliğini önemli ölçüde artırmak için güçlü bir kombinasyondur. Doğru yapılandırma ve strateji seçimi ile, veritabanı üzerindeki yükü azaltabilir, yanıt sürelerini kısaltabilir ve daha iyi bir kullanıcı deneyimi sunabilirsiniz. Ancak, önbellekleme her derde deva bir çözüm değildir ve dikkatli bir planlama, yapılandırma ve test gerektirir.

Sıkça Sorulan Sorular (SSS)

S: Birinci ve İkinci Seviye Önbellek arasındaki temel fark nedir?

C: Birinci Seviye Önbellek, Session‘a özeldir ve oturum kapandığında temizlenir. İkinci Seviye Önbellek ise SessionFactory‘ye bağlıdır, tüm oturumlar arasında paylaşılır ve daha kalıcıdır.

S: Hangi önbellek stratejisini (CacheConcurrencyStrategy) seçmeliyim?

C:
* READ_ONLY: Veriler asla değişmeyecekse.
* READ_WRITE: Veriler değişebilir ve tutarlılık önemliyse (en yaygın).
* NONSTRICT_READ_WRITE: Veriler nadiren değişirse ve küçük tutarsızlıklar kabul edilebilir.
* TRANSACTIONAL: JTA ortamlarında en yüksek tutarlılık gerekiyorsa.

S: Dağıtık bir ortamda EHCache nasıl kullanılır?

C: Tek başına EHCache dağıtık ortamlar için veri tutarlılığı sağlamaz. Bu durumda Terracotta ile dağıtık EHCache kullanabilir veya Redis, Infinispan gibi harici dağıtık önbellek çözümlerini Hibernate’in JCache entegrasyonu üzerinden yapılandırabilirsiniz.

S: Sorgu önbelleği her zaman iyi bir fikir midir?

C: Hayır. Sıkça aynı parametrelerle çağrılan, sonuçları sık değişmeyen sorgular için çok faydalıdır. Ancak sık değişen sorgular veya çok farklı parametrelerle çağrılan sorgular için önbellek isabet oranı düşük olur ve önbellek yönetimi ek yük getirebilir. Ayrıca, sorgu önbelleği sadece varlık ID’lerini saklar; varlıkların kendileri için de İkinci Seviye Önbelleği etkinleştirmeniz gerekir.

S: Önbelleği ne zaman devre dışı bırakmalıyım?

C:
* Veri çok sık değişiyorsa ve her zaman en güncel veriye ihtiyacınız varsa.
* Bellek kullanımının kritik olduğu ve önbelleğin çok büyük veriler tutacağı durumlarda.
* Uygulamanızda performans darboğazı veritabanından değil, başka bir bileşenden kaynaklanıyorsa.
* Uygulamanızın zaten çok az veritabanı sorgusu yaptığı ve önbelleklemenin getireceği ek karmaşıklığa değmeyeceği durumlarda.