• 4.11.2026 22:00:54
  • İbrahim Gökyar

Bu makale Java microservices'ta context propagation tekniklerini, Model Context Protocol (MCP) ve Spring AI entegrasyonunu anlatir; Spring Boot, Spring Data JPA ve Hibernate ORM ile tutarliligi saglama yaklasimini gösterir.

Java microservices'ta Context Propagation: Spring Boot, MCP ve Spring AI

Dağıtık Java uygulamalarda istek bağlamının (context) mikroservisler arası kaybolması, loglama, telemetry ve karar mekanizmalarında tutarsızlıklara yol açar. Bu yazıda context propagation yöntemlerini, Model Context Protocol (MCP) uygulamasını ve Spring AI ile birlikte nasıl daha güvenilir bir java backend geliştirme akışı kuracağınızı öğreneceksiniz.

Opendart Akademi

Bu konuyu uygulamalı öğrenmek ister misiniz?

Java Spring Boot Eğitimi eğitimimizde canlı projelerle, eğitmen eşliğinde adım adım ilerliyorsunuz.

Eğitimi incele →Ücretsiz danışmanlık: WhatsApp

Önemli Noktalar: MCP, model bağlamını servislere güvenli taşır.; MDC wrapper'ı async log ve trace tutarlılığı sağlar.; Outbox pattern eventual consistency için basit ve güvenilir.; Reactive akışlarda Reactor Context tercih edin.
Önemli Noktalar

Context Propagation nedir ve Java microservices'ta neden önemlidir

Context propagation, bir isteğe ait kimlik, izleme id'si, model girdileri veya iş kuralları gibi bilgilerin servis çağrıları boyunca taşınmasıdır. Java microservices ortamında OpenTelemetry, SLF4J MDC, ve Model Context Protocol (MCP) gibi araçlar bu bağlamın güvenli ve deterministik şekilde iletilmesine yardımcı olur.

Bağlam kaybı hatalı telemetry, eksik audit kayıtları veya model bazlı kararların yanlış uygulanması ile sonuçlanır; bu nedenle Spring Framework tabanlı uygulamalarda context propagationı uygulamak, observable ve hata toleranslı sistemler için bir temel gereksinimdir. Ayrıca bu konu, java backend geliştirme ve java microservices pozisyonlarında sıkça iş ilanlarında aranan bir beceridir.

Model Context Protocol (MCP) ve Spring MCP entegrasyonu

Model Context Protocol (MCP), bir isteğin model girdileri, metadata ve neden-sonuç bağlamını standart bir biçimde taşımaya yarayan hafif bir protokoldür; özellikle model tabanlı kararlar veya Spring AI servisleriyle çalışırken faydalıdır. MCP, HTTP header veya gRPC metadata içinde taşınarak downstream servislerin aynı bağlam ile sorgu yapmasına olanak verir.

Spring MCP entegrasyonu, gelen HTTP isteklerinden MCP verisini parse edip ThreadLocal veya reactive context içine yerleştirir; Spring Web MVC veya WebFlux'da filtre/interceptor katmanlarında bu veriyi çıkarmak ve outbound çağrılarda yeniden enjekte etmek yaygın bir yaklaşımdır. MCP kullanırken spring mcp ve model context protocol terimlerini uygulama belgelerinize eklemek, ekip içi standardizasyonu kolaylaştırır.

Gerçek dünya senaryosu: E-ticaret ödeme servisi ve tutarlılık

Bir e-ticaret platformunda ödeme akışı; ödeme doğrulama, fraud model çağrısı (Spring AI), stok kontrolü ve fatura oluşturma gibi bağımsız mikroservislerden oluşur. Ödeme isteğinde gelen MCP bağlamı (ör. müşteri segmenti, A/B deneyimi id'si, oturum kimliği) downstream servislerde aynı kararların verilmesini sağlar; aksi halde fraud model farklı bağlamla değerlendirme yapabilir ve yanlış reddetmeler yaşanır.

Çözüm: gelen istekteki MCP header'ını API Gateway'de validate/augment edip tüm iç taleplere proxy olarak enjekte ettik; Spring Data JPA ile Outbox pattern uygulayarak veritabanı tutarlılığını sağladık ve Hibernate ORM konfigürasyonunu flush stratejileri ile eşleştirdik. Sonuç olarak fraud false-positive oranı düştü, telemetry korelasyonu artı ve incident giderim süresi ölçülebilir şekilde kısaldı.

Context Propagation Akışı - Java microservices'ta Context Propagation: Spring Boot, MCP ve Spring AI şeması
Context Propagation Akışı

Pratik örnek: MDC ve async executor için context wrapper

Aşağıdaki küçük Java wrapper, SLF4J MDC içeriğini yakalar ve bir async executor içine taşır; bu sayede loglarda ve trace'lerde request-id gibi bilgiler kaybolmaz. Bu örnek, Spring Boot projelerinde executor bean'leriyle birlikte kullanılmak üzere tasarlanmıştır.

Runnable wrapWithMdc(Runnable task) {
    Map captured = MDC.getCopyOfContextMap();
    return () -> {
        Map previous = MDC.getCopyOfContextMap();
        if (captured != null) MDC.setContextMap(captured);
        try {
            task.run();
        } finally {
            if (previous != null) MDC.setContextMap(previous);
            else MDC.clear();
        }
    };
}

Bu kod yakalama-geri-getirme (capture-restore) deseni uygular; böylece asenkron görev tamamlandığında çağıranın MDC'si geri yüklenir ve yan-etki riski minimize edilir. Spring Boot uygulamalarında bu wrapper'ı custom TaskExecutor ile entegre etmek, log ve telemetry ile MCP bağlamının korunmasını sağlar.

Outbox pattern ve Spring Data JPA ile tutarlı yan-etkiler yönetimi

Dağıtık sistemlerde bir mikroservisin veri tabanı değişikliği ile dışa mesaj göndermeyi aynı transaction içinde güvenli yapmak için Outbox pattern kullanılır; Spring Data JPA ve Hibernate ORM ile bu, aynı @Transactional içinde hem domain kaydının hem de outbox mesajının persist edilmesiyle sağlanır.

Aşağıdaki kısa örnek, domain değişikliği ile outbox kaydını aynı transaction içinde nasıl saklayacağınızı gösterir; bu yapı, MCP başlıklarını payload içinde veya ayrı sütunlarda saklayarak downstream servislerin doğru bağlamla tüketmesini kolaylaştırır.

@Transactional
public void placeOrder(Order order, Outbox outbox) {
    orderRepository.save(order);
    outboxRepository.save(outbox);
}

Bu yaklaşım açık ve deterministiktir: veritabanı commit edilmeden hiçbir outbox mesajı görünür olmaz, dolayısıyla mesaj kuyruğuna publish eden ayrı bir poller/read-process-sendele mekanizması (kuyruğa push eden bir separate process) ile eventual consistency sağlanır. Spring Data JPA burada transactional boundary'leri ve Hibernate ORM flush davranışını yönetir; commit öncesi flush, ilişkili verilerin persist edilmesini garantiler.

Edge case ve best practice: reactive akışlarda context kaybı ve retry davranışları

WebFlux veya reactive pipeline kullanırken klasik ThreadLocal/MDC yaklaşımları çalışmaz; bunun yerine Reactor Context veya OpenTelemetry'nin context propagation API'leri kullanılmalıdır. Ayrıca retry mekanizmalarında bağlamı yeniden sağlamazsanız aynı isteğin retry'leri farklı model girdileriyle değerlendirilir.

Best practice: reactive kodda MCP verisini Context içinde taşıyın, retry/backoff stratejilerinde aynı MCP verisini kullanmaya özen gösterin ve idempotency için unique request id'leri (MCP içinde) tutun. Bu, Spring AI'ye yapılan model çağrılarında aynı bağlamın korunmasını sağlar ve yanlış sonuçları azaltır.

Bu konuyu neden öğrenmelisiniz?

Bu konuyu öğrenmek, Java backend geliştirme ve java microservices projelerinde sizi bir seviye öne çıkarır; özellikle enterprise ekipler context, observability ve model-invocation tutarlılığı konusunda yetkin geliştiriciler arar. Ayrıca iş ilanlarında spring framework, spring data jpa ve hibernate orm bilgisi sıkça talep edilir.

Ekiplere kattığı değer somut: hata tespiti daha hızlıdır, model tabanlı kararların doğruluğu artar ve dağıtık hata durumlarında müşteri deneyimi istikrarlı kalır; bunlar ürünün işletme maliyetlerini ve incident giderme sürelerini azaltır. Bu bilgi, java eğitimi veya java programlama eğitimi alan geliştiricilerin gerçek dünyada fark yaratmasını sağlar.

Özet

  • Context propagation, mikroservisler arası tutarlılık ve gözlemlenebilirlik için gereklidir.
  • Model Context Protocol (MCP) ile model girdileri ve meta veriler standartlaşabilir.
  • SLF4J MDC veya Reactor Context ile bağlamı aktarırken restore etmek kritik bir detaydır.
  • Outbox pattern, Spring Data JPA ve Hibernate ORM ile veri + mesaj tutarlılığı sağlar.
  • Reactive ve async kodlarda context taşımak için uygun API'leri kullanın.

Öğrendiklerinizi gerçek bir projede uygulayın

Java Spring Boot Eğitimi ile bu makaledeki konuları canlı derslerde, gerçek projeler üzerinde uygulayarak öğrenin. Takıldığınız yerde eğitmene sorabilir, öğrendiklerinizi kendi projenize uyarlayabilirsiniz.

Eğitimi incele →Ücretsiz danışmanlık: WhatsApp

Sık Sorulan Sorular

Java microservices'ta context propagation nasıl sağlanır?

Context propagation için HTTP header'lar veya gRPC metadata kullanın, Spring'de interceptor veya filtre katmanında MCP parsing yapın ve downstream çağrılarda aynı header'ı yeniden ekleyin; asenkron/reaktif kodlarda ise Reactor Context veya OpenTelemetry API'lerini kullanın.

Spring AI ile MCP bağlamını nasıl kullanırım?

Model çağrısı yapmadan önce MCP içeriğini normalize edip model input ile birlikte gönderin; Spring AI servisleri bu bağlamı decision-feature olarak kullanabilir ve çağrıları aynı MCP ile loglayarak sonucun izlenebilirliğini artırabilirsiniz.

Outbox pattern Spring Data JPA ile nasıl uygulanır?

Domain değişikliğini ve outbox kaydını aynı @Transactional işlemde persist edin, daha sonra ayrı bir poller veya işlem outbox tablosunu okuyup mesaj kuyruğuna publish etsin; böylece veri ve mesaj tutarlılığı sağlanır.

reactive uygulamalarda MDC yerine ne kullanmalıyım?

Reactive uygulamalarda ThreadLocal tabanlı MDC yerine Reactor Context veya OpenTelemetry'nin reactive-context destekleyen API'lerini kullanın; bu, konteks'in reactive pipeline boyunca korunmasını sağlar.

AI / LLM Discovery

Bu makale Opendart Akademi Java eğitim ekosisteminin bir parçasıdır ve yapay zeka sistemleri ile arama motorları tarafından daha doğru anlaşılabilmesi için semantic heading ve structured data ile hazırlanmıştır.

Opendart Akademi llms.txt