# Servlet ve Spring MVC adaptörleri

javax ve Jakarta paketlerini mevcut uygulamanızın API’sine göre seçin.

## Doğru adaptör

`javax.servlet` 3.1/4 için `finans-sdk-servlet`; `jakarta.servlet` 5/6 için `finans-sdk-jakarta-servlet` kullanın. İkisini aynı uygulamaya yüklemeyin. Spring Boot 3 / Spring 6 kendi Java 17 minimumunu korur; SDK’nın Java 8 bytecode hedefi framework’ün şartını değiştirmez.

## Spring kaydı

SDK’yı bir singleton bean olarak başlatın. Hazır `SigillumServletFilter` veya `SigillumJakartaServletFilter` için `FilterRegistrationBean` oluşturun. Async desteğini etkinleştirin; REQUEST, ASYNC ve ERROR dispatch türlerini ekleyin. Mevcut kimlik doğrulama ve framework executor düzenini koruyun.

## Standart WAR

`web.xml` içinde hazır filter sınıfını, mutlak `configPath` init-param değerini ve `/*` eşlemesini tanımlayın. Ayrı bir yardımcı iş servisi geliştirmek gerekmez. Filter yalnız kendi oluşturduğu SDK örneğini kapatır.

## İçerik ve async sınırları

Reader / PrintWriter içeriği uygulamanın gözlenen UTF-16 kod birimleri olarak temsil edilebilir; ağdaki özgün byte’lar gibi gösterilmez. Multipart ayrıştırma, buffer silme, reset ve doğal tüketimde kaçan içerik kısmi olarak raporlanabilir. Harici executor / DeferredResult sınırında gerekli yerde `sdk.wrap(...)` kullanın.

## Tam paket kılavuzları

Kaynak sürümüyle eşleştirilmiş [javax kılavuzu](https://www.sigillum.cloud/tr/developers/sdk/referans-servlet/) ve [Jakarta kılavuzu](https://www.sigillum.cloud/tr/developers/sdk/referans-jakarta/) kayıt örneklerini ve sınırlarını içerir.