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 ve Jakarta kılavuzu kayıt örneklerini ve sınırlarını içerir.