Spring ile Veritabanı İşlemleri: Spring Data, Transaction ve Performans İpuçları

Bu makalede Spring ekosisteminde veritabanı (RDBMS) işlemlerini nasıl daha güvenli, okunabilir ve performanslı hale getirebileceğinizi ele alacağız. Hedefimiz, çalışan yazılımcıların günlük projelerinde doğrudan uygulayabileceği stratejiler, kod örnekleri ve geçiş yolları sunmaktır. Hem klasik JDBC tabanlı yaklaşımları hem de modern Spring Data JPA kullanımını ve geçiş senaryolarını açıklayacağım.

Spring ile Veritabanı Katmanına Bakış

Spring Framework, veri katmanında farklı soyutlama seviyeleri sunar: temiz JDBC kullanımı, JdbcTemplate, MyBatis gibi mapper'lar ve yüksek seviyede Spring Data JPA/Repository tabanlı modeller. Hangi seviyeyi kullanacağınız projenizin karmaşıklığı, performans gereksinimleri ve ekip deneyimine bağlıdır.

Küçük bir servis için basit JdbcTemplate iyi sonuç verirken, karmaşık ilişkisel modeller ve hızlı geliştirme gereksinimleri için Spring Data JPA çoğu ekipte tercih edilir. Ancak ORM kullanırken N+1, lazy loading gibi tuzaklara dikkat etmek gerekir; bu yüzden transaction yönetimi ve sorgu optimizasyonu hayati önem taşır.

JdbcTemplate vs Spring Data JPA: Ne Zaman Hangisini Seçmeli?

JdbcTemplate doğrudan SQL ile çalışır; kontrol sizdedir. Karmaşık sorgular, performans kritik raporlar veya veritabanı-spesifik optimizasyon gerektiğinde JdbcTemplate veya MyBatis daha uygun olabilir. Avantajı, SQL üzerinde tam hakimiyet ve az soyutlama dolayısıyla tahmin edilebilir performanstır.

Spring Data JPA ise entity, repository ve sorgu türetme mekanizmalarıyla geliştirme hızını artırır. Basit CRUD işlemleri için boilerplate kod büyük oranda azalır. Ancak JPA kullanırken entity tasarımı, fetch stratejileri ve DTO projeksiyonları gibi konuları bilinçli yönetmezseniz beklenmedik sorgular tetiklenebilir.

<!-- Basit bir JdbcTemplate örneği -->
@Autowired
private JdbcTemplate jdbcTemplate;

public List<User> findActiveUsers() {
    return jdbcTemplate.query("SELECT id, username FROM users WHERE active = ?",
        new Object[]{true},
        (rs, rowNum) -> new User(rs.getLong("id"), rs.getString("username"))
    );
}

<!-- Spring Data JPA repository -->
public interface UserRepository extends JpaRepository<User, Long> {
    List<User> findByActiveTrue();
}

Transaction Yönetimi: @Transactional ve En İyi Uygulamalar

Doğru transaction yönetimi verinin tutarlılığı için kritik. Spring'in @Transactional notasyonu çoğu senaryoda yeterlidir, ancak scope, propagation ve readOnly gibi özellikleri doğru kullanmak gerekir. Özellikle servis katmanında transaction başlatmak, repository/DAO seviyesindeki işlemleri tek bir mantıksal birime bağlamak en iyi uygulamadır.

Önemli noktalar: @Transactional yalnızca public metotlarda, aynı sınıf içindeki private çağrılarda proxy nedeniyle tetiklenmeyebilir. Ayrıca long-running transaction'lardan kaçının; uzun süre açık transaction'lar kilitlenmelere yol açar. Read-only işlemler için readOnly=true işaretlemek DB optimizasyonlarına yardımcı olabilir.

@Service
public class OrderService {

    @Transactional
    public void placeOrder(OrderDto dto) {
        // Validasyon, stoğun düşülmesi, ödeme işlemi, sipariş kaydı
    }

    @Transactional(readOnly = true)
    public Order getOrder(Long id) {
        return orderRepository.findById(id).orElseThrow();
    }
}

Sorgu Optimizasyonu: DTO Projeksiyonları ve Paging

JPA ile çalışırken tüm entity'leri yüklemek yerine DTO projeksiyonları kullanmak bellek kullanımını düşürür ve gereksiz join'leri azaltır. Spring Data projection veya JPQL/criteria ile doğrudan DTO'ya çekmek performans açısından faydalıdır. Ayrıca liste dönen API'larda sayfalama (paging) ve sıralama uygulamak zorunludur.

Spring Data, Pageable ve Slice arayüzleri ile kolayca sayfalandırma sağlar. Büyük sonuç kümelerini stream şeklinde tüketmek için Java 8 Stream destekleri veya JdbcTemplate ile cursor tabanlı okuma tercih edilebilir.

// DTO projeksiyon örneği (Spring Data interface projection)
public interface UserSummary {
    Long getId();
    String getUsername();
}

public interface UserRepository extends JpaRepository<User, Long> {
    Page<UserSummary> findByActiveTrue(Pageable pageable);
}

Geçiş Stratejileri: Eski JDBC Kodundan Spring Data'ya

Legacy JDBC kodu olan projelerde Spring Data'ya geçiş kademeli yapılmalıdır. Önce servis katmanını soyutlayın; repository arayüzleri oluşturun ve mevcut JdbcTemplate kodunu bu arayüzleri uygulayacak şekilde sarmalayın. Böylece tüketiciler repository arayüzleriyle çalışır, implementasyon arka planda değiştirilebilir.

Adımlar önerisi:

• Mevcut SQL'leri ve performans kritik sorguları envanterleyin.
• Basit CRUD için Spring Data JPA repository'leri oluşturun, test edin.
• Performans hassas sorguları JdbcTemplate veya native query olarak bırakın veya optimize edin.
• Transactional sınırlarını netleştirin; servis katmanına taşıyın.
• Test kapsamını genişletin: entegrasyon testleri ile veri tutarlılığını doğrulayın.

Pratik İpuçları ve Kaçınılması Gereken Hatalar

Çok sık görülen hatalar: lazy loading kaynaklı LazyInitializationException, açık transaction içinde uzun süre bekleyen I/O, gereksiz N+1 sorguları. Bu hatalardan korunmak için fetch join'ler, entity graph'lar veya DTO projeksiyonları kullanın. Ayrıca connection pool yapılandırmasını (HikariCP yaygın tercihtir) uygulama yüküne göre ayarlayın.

Log seviyesini production'da dikkatle ayarlayın; Hibernate SQL logları geliştirme ortamında faydalıyken üretimde performansı etkileyebilir. Ölçümler (profiling, APM) yapmadan optimizasyon yapmak yanıltıcı olabilir; önce bottleneck'i ölçün sonra müdahale edin.

Sık Sorulan Sorular

1) Spring Data JPA kullanırken N+1 problemini nasıl tespit ederim?

Geliştirme ortamında Hibernate SQL loglarını açarak veya uygulama performans araçları (ör. APM) ile izleyerek N+1 sorgu örüntülerini görebilirsiniz. Sorun genelde koleksiyonların lazy yüklenmesinden kaynaklanır. Çözüm olarak fetch join (JPQL), @EntityGraph veya DTO bazlı projeksiyon kullanabilirsiniz.

2) Transaction propagation nedir, hangi propagation türünü seçmeliyim?

Propagation, bir metot zaten açık bir transaction içindeyken yeni bir transaction başlatma davranışını tanımlar. DEFAULT çoğu zaman REQUIRED'dir (mevcut transaction'a katılır). İzolasyon ve rollback davranışlarına göre REQUIRES_NEW veya SUPPORTS gibi türler seçilebilir. Karmaşık senaryolarda öncelikle REQUIRED ile ilerleyip ihtiyaç oldukça spesifik propagation kullanın.

3) Spring Data ile büyük veri setlerini verimli okumak için ne yapmalıyım?

Büyük veri setlerinde sayfalama (Pageable) veya stream tabanlı okuma tercih edin. JPA level'da setFetchSize veya ScrollableResults kullanımıyla bellek tüketimini azaltabilirsiniz. Alternatif olarak JdbcTemplate ile cursor/stream okuyup satırları işlemek en verimli yöntemdir.

Sonuç

Spring ile veritabanı işlemleri, doğru araç ve yaklaşımla hem hızlı geliştirme hem de yüksek performans sağlayabilir. JdbcTemplate ve Spring Data JPA arasında bilinçli seçim yapmak, transaction yönetimini servis katmanına taşımak ve sorgu optimizasyonlarını (DTO projeksiyonları, paging, fetch stratejileri) uygulamak gerçek dünya projelerinde fark yaratır. Mevcut legacy kodlardan modern Spring Data yaklaşımlarına kademeli geçiş, riskleri azaltır ve bakım maliyetlerini düşürür. Uygulamanızın ihtiyaçlarına göre ölçüm yapmadan değişiklik uygulamayın; önce veriyi ölçün, sonra optimize edin.