Jersey ile REST API Geliştirme ve Test Eğitimi

Eğitim Hakkında

JAX-RS ile REST API tasarımı, güvenlik ve test otomasyonu

Bu eğitim, Jersey (JAX-RS referans gerçeklemesi) ile REST API geliştirme ve test etmeyi uçtan uca işler. @Path, @GET/@POST/@PUT/@DELETE, @PathParam, @QueryParam, @Consumes/@Produces, Response ve durum kodları, Jackson ile JSON bağlama, Bean Validation, ExceptionMapper ile hata yönetimi, ContainerRequestFilter/ContainerResponseFilter ve @NameBinding, CORS, Basic/JWT kimlik doğrulama ele alınır. Test tarafında JerseyTest, REST Assured, Postman/Newman, WireMock ile bağımlılık taklidi, JUnit 5 ve Mockito ile birim testleri ile OpenAPI belgelendirme uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar jersey ile api geliştirme konusundan başlayıp güvenlik ve test konusuyla tamamlar.

Seviye

Orta Seviye — Jersey (JAX-RS) ile REST API geliştirme, JSON işleme, hata yönetimi, güvenlik ve otomatik testler.

Öğrenme Metodu

Bir kitap/sipariş API'si adım adım geliştirilir; her uç nokta için önce test yazılır ve Postman ile REST Assured senaryoları çalıştırılır.

Neden Bu Eğitim?

🌐REST Tasarımı

Kaynak odaklı URI ve doğru HTTP yöntemleriyle temiz API tasarlarsınız.

🧪Test Otomasyonu

JerseyTest ve REST Assured ile API regresyon testlerini otomatikleştirirsiniz.

🔑Güvenli API

JWT ve filtrelerle uç noktaları korursunuz.

Anahtar Konular

jersey rest apijax-rsjava rest api geliştirmejersey testrest assuredjerseytestjava api testjwt jerseyrest api test otomasyonuopenapi swagger java

“Test edilmemiş API, yazılmamış sözleşmedir.”

Ön Koşullar

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

1

Java Temeli

Sınıf, koleksiyon ve istisna yönetimi gibi temel Java bilgisi beklenir.

2

HTTP Bilgisi

İstek-yanıt modeli, durum kodları ve başlık kavramlarına aşinalık faydalıdır.

3

Uygulama Sunucusu

Tomcat, Jetty veya benzeri bir servlet konteyneri kurulumu yapılabilecek ortam gerekir.

4

Araçlar

Maven ile proje oluşturma ve IDE üzerinden dağıtım yapma deneyimi yararlıdır.

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ı, Jersey ile CRUD işlemleri yapan, doğrulanmış ve standart hata dönen bir REST API geliştirir.

Modül 1

REST ve Jersey Kurulumu

REST kısıtları ve Richardson olgunluk modeli
Jersey + Grizzly veya Tomcat kurulumu
ResourceConfig ve paket tarama
Maven bağımlılıkları (jersey-container, jersey-hk2)
Uygulama yaşam döngüsü ve kaynak sınıfı
URI tasarımı: çoğul isimler ve iç içe kaynaklar

Modül 2

Kaynak Metotları

@Path, @GET, @POST, @PUT, @DELETE, @PATCH
@PathParam, @QueryParam, @HeaderParam, @FormParam
@Consumes ve @Produces ile içerik pazarlığı
Response.status, created(URI) ve noContent
@BeanParam ile parametre gruplama
Alt kaynak (sub-resource locator)

Modül 3

JSON ve Doğrulama

jersey-media-json-jackson entegrasyonu
DTO tasarımı ve @JsonIgnore, @JsonProperty
Tarih ve zaman biçimleri (java.time)
Bean Validation: @NotNull, @Size, @Valid
ValidationExceptionMapper ile 400 yanıtı
Sayfalama, sıralama ve filtre parametreleri

Modül 4

Hata ve Filtreler

ExceptionMapper<T> ile merkezi hata yönetimi
WebApplicationException ve özel hata modeli
ContainerRequestFilter ve ContainerResponseFilter
@NameBinding ile seçmeli filtre
Loglama ve korelasyon kimliği filtresi
CORS filtresi ve preflight

Günün hedefiKatılımcı, API'yi JWT ile korur ve birim, entegrasyon ve sözleşme testlerini otomatikleştirir.

Modül 1

Kimlik Doğrulama

Basic auth filtresi ve tuzakları
JWT üretme ve doğrulama (jjwt, nimbus)
SecurityContext ve @RolesAllowed
RolesAllowedDynamicFeature kaydı
Oran sınırlama (rate limit) filtresi
HTTPS, HSTS ve güvenli başlıklar

Modül 2

Birim Testleri

JUnit 5 ve Mockito ile servis testleri
Repository taklidi ve test verisi
Parametrik test ile doğrulama kuralları
AssertJ ile okunur doğrulamalar
Test kapsamı (JaCoCo)
Test verisi oluşturucu (builder) deseni

Modül 3

API Entegrasyon Testleri

JerseyTest ile bellek içi sunucu
configure() ve target().path().request()
REST Assured ile given-when-then
JSON path doğrulaması ve şema doğrulama
WireMock ile dış servis taklidi
Testcontainers ile gerçek veritabanı

Modül 4

Belgelendirme ve Otomasyon

OpenAPI/Swagger annotation'ları ve swagger-jersey2-jaxrs
Postman koleksiyonu ve ortam değişkenleri
Newman ile CI'da koşturma
Sözleşme (contract) testi fikri
Yük testi: k6 veya JMeter'a giriş
CI hattı: Maven + test + rapor

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

Jersey Kurulum

Jersey projesini ResourceConfig ile kurup çalıştırabilirsiniz.

🧠

REST Tasarımı

Kaynak odaklı URI ve doğru HTTP yöntemleriyle API tasarlayabilirsiniz.

⚙️

JSON Bağlama

Jackson ile DTO dönüşümü ve doğrulama yapabilirsiniz.

🔍

Hata Yönetimi

ExceptionMapper ile tutarlı hata yanıtları üretebilirsiniz.

🛠️

Filtre Kullanımı

Request/response filtreleri ve NameBinding uygulayabilirsiniz.

📈

JWT Güvenliği

JWT ile uç noktaları koruyup rol bazlı yetkilendirme yapabilirsiniz.

🧩

Test Yazma

JerseyTest ve REST Assured ile entegrasyon testi yazabilirsiniz.

🚀

API Belgesi

OpenAPI ile API'yi belgeleyip Postman/Newman ile otomatikleştirebilirsiniz.

Kimler İçin Uygundur?

Java ve temel HTTP bilgisine sahip
REST API geliştirmek
test otomasyonu kurmak isteyen backend geliştiricileri ve test mühendisleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Java ve temel HTTP bilgisine sahip, REST API geliştirmek ve test otomasyonu kurmak isteyen backend geliştiricileri ve test mühendisleri için uygundur.

JAX-RS ile Spring REST farkı eğitimde ele alınıyor mu?

Kısa bir karşılaştırma yapılır; ancak uygulamalar JAX-RS ve Jersey üzerinedir. Öğrenilen kavramlar (HTTP, JSON, test) Spring'e de aktarılabilir.

Test araçları kurulum gerektirir mi?

Maven bağımlılıkları ile JerseyTest ve REST Assured gelir; Postman ücretsiz sürümü ve Newman için Node.js kurulumu önerilir.

Eğitim için hangi ön bilgi ve ortam gerekir?

Sınıf, koleksiyon ve istisna yönetimi gibi temel Java bilgisi beklenir. İstek-yanıt modeli, durum kodları ve başlık kavramlarına aşinalık faydalıdır. Tomcat, Jetty veya benzeri bir servlet konteyneri kurulumu yapılabilecek ortam gerekir.

Eğitim sonunda sertifika verilir mi?

Eğitimi tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir. 2 günlük program boyunca uygulama çalışmalarının tamamlanması beklenir.

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

API GELİŞTİRME VE TESTİ JAVA (JERSEY) KULLANARAK EĞİTİMİ