Spring Boot ile RESTful API Servisleri

Eğitim Hakkında

Spring Boot ile olgun RESTful API servisleri

Eğitim, bir mikroservisin dış yüzü olan RESTful API'nin olgun biçimde tasarlanmasına odaklanır. Kaynak odaklı URL, HTTP semantiği, sayfalama-filtre, Bean Validation ve RFC 7807 ProblemDetail yanıtları işlenir. Spring HATEOAS ile bağlantılı kaynaklar, ETag ve Cache-Control ile koşullu istekler, Spring Cache ve Caffeine uygulanır. API sürümleme ve geriye dönük uyumluluk, resource server olarak JWT doğrulama, rate limiting, OpenAPI dokümantasyonu ve Pact ile sözleşme testi ele alınır.

Süre ve Format

2 Gün. Her gün dört modül; Kaynak Tasarımı ve Hata Yönetimi; Performans, Evrim ve Güvenlik ekseninde ilerleyen uygulamalı program.

Seviye

Orta Seviye — Spring Boot mikroservislerinde RESTful API servisi geliştirme: kaynak tasarımı, HATEOAS, önbellek, sürümleme, güvenlik ve dokümantasyon.

Öğrenme Metodu

Bir sipariş mikroservisi API'si yinelemeli iyileştirilir: her modülde bir olgunluk özelliği eklenir ve sözleşme testle korunur.

Neden Bu Eğitim?

🏛️Olgun API

Richardson olgunluk modelinin üst seviyelerini pratikte uygularsınız.

⚡Hız ve Önbellek

ETag ve cache ile gereksiz trafiği azaltırsınız.

📜Sözleşme Güvencesi

Pact ve OpenAPI ile tüketicileri kırmadan API'yi evriltirsiniz.

Anahtar Konular

restful api spring bootspring hateoasapi sürümlemespring cacherest api güvenliğispring boot mikroservis apiproblemdetailopenapi springpact contract testingrest api tasarımı

“API'yi değiştirmek kolaydır; tüketicileri kırmadan değiştirmek tasarımdır.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1

Spring Boot

Controller ve servis katmanı yazabilecek Spring Boot bilgisi gerekir.

2

REST Temeli

HTTP ve JSON bilgisi gerekir.

3

Araçlar

JDK 17+, Maven, IDE ve Postman gerekir.

4

Docker

İsteğe bağlı Redis için Docker önerilir.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı kaynak odaklı API tasarlar, tutarlı hata yanıtı ve bağlantılı kaynaklar üretir.

Modül 1

REST API Tasarımı

Kaynak odaklı URL tasarımı ve çoğul isimlendirme
HTTP metot ve durum kodu eşlemesi
Idempotency ve güvenli metotlar
Sayfalama, filtreleme ve sıralama parametreleri
API sürümleme stratejileri
HATEOAS ve Spring HATEOAS temelleri

Modül 2

Doğrulama ve Hata Yönetimi

Bean Validation: @NotNull, @Size, @Email, @Pattern
@Valid ve MethodArgumentNotValidException
@ControllerAdvice ve @ExceptionHandler
RFC 7807 ProblemDetail yanıtı
Özel validator (ConstraintValidator)
Tutarlı hata yanıt şeması

Modül 3

HATEOAS ve Bağlantılı Kaynaklar

Richardson olgunluk modeli
Spring HATEOAS: EntityModel ve CollectionModel
Bağlantı (link) üretimi: WebMvcLinkBuilder
HAL formatı ve istemci tüketimi
Sayfalamada next/prev bağlantıları
HATEOAS'ın faydası ve maliyeti

Modül 4

Spring MVC İstek Akışı

DispatcherServlet ve istek işleme zinciri
@Controller ve @RestController
@RequestMapping, @PathVariable, @RequestParam
@RequestBody ve HttpMessageConverter
Interceptor ve Filter farkı
ResponseEntity ile yanıt kontrolü

Günün hedefiKatılımcı API'yi önbellekler, sürümler, güvenceye alır ve belgelendirir.

Modül 1

Önbellek ve Koşullu İstekler

ETag ve If-None-Match ile 304 yanıtı
Cache-Control başlığı yönetimi
Spring Cache soyutlaması ve @Cacheable
Caffeine ve Redis önbellek sağlayıcıları
Önbellek geçersiz kılma (@CacheEvict)
Önbellek isabet oranı metriği

Modül 2

API Sürümleme ve Evrim

URL, başlık ve medya tipi ile sürümleme
Geriye dönük uyumluluk kuralları
Alan ekleme ve kaldırma politikası
Deprecation ve Sunset başlığı
Tüketici odaklı sözleşme testleri (Pact)
Sürüm geçiş planı

Modül 3

REST API Güvenliği

Spring Security ile kaynak sunucu (resource server)
JWT doğrulama ve scope tabanlı yetki
Rate limiting (Bucket4j)
Girdi doğrulama ve mass assignment riskleri
OWASP API Security Top 10 özeti
CORS ve güvenli başlıklar

Modül 4

OpenAPI Dokümantasyonu

springdoc-openapi ile Swagger UI
@Operation ve @Schema ile açıklama
Güvenlik şemasının dokümanda gösterimi
OpenAPI'den istemci üretimi
Sözleşme öncelikli (contract-first) yaklaşım
Dokümantasyonu CI'da doğrulama

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

Kaynak Tasarımı

Kaynak odaklı URL ve doğru durum kodları kullanabilirsiniz.

🧩

ProblemDetail

RFC 7807 uyumlu hata yanıtları üretebilirsiniz.

⚙

HATEOAS

Bağlantılı kaynak modelleri sunabilirsiniz.

️

Koşullu İstek

ETag ile 304 yanıtı uygulayabilirsiniz.

🔍

Önbellek

Spring Cache ile sorgu sonuçlarını önbellekleyebilirsiniz.

🛠

Sürümleme

Geriye dönük uyumlu API evrimi planlayabilirsiniz.

️

API Güvenliği

JWT ve scope ile uç noktaları koruyabilirsiniz.

🧪

Sözleşme Testi

Pact ile tüketici sözleşmesini doğrulayabilirsiniz.

Kimler İçin Uygundur?

Spring Boot
servis geliştiren ve API kalitesini artırmak isteyen backend geliştiricileri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Spring Boot ile servis geliştiren ve API kalitesini artırmak isteyen backend geliştiricileri için uygundur.

HATEOAS her API için gerekli mi?

Hayır; faydası ve maliyeti eğitimde tartışılır, gerekli olduğu senaryolarda uygulanır.

API sürümleme için hangi yöntem önerilir?

Yöntemlerin artı-eksileri karşılaştırılır; seçim tüketici profiline bağlıdır.

Pact nedir?

Tüketici ve sağlayıcı arasındaki sözleşmeyi test eden araçtır.

Eğitim sonunda sertifika verilir mi?

Katılım ve değerlendirme sonrasında Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika

SPRING BOOT MICROSERVICES: BUILDING RESTFUL API SERVICES EĞİTİMİ