RESTful Servisler: REST/JAX-RS Programlama

Eğitim Hakkında

JAX-RS ile REST servis geliştirme

Eğitim REST kısıtlarını, Richardson olgunluk modelini ve HTTP semantiğini; @Path, @GET/@POST, @PathParam/@QueryParam, @Produces/@Consumes ile JAX-RS kaynak yazımını; Jackson/JSON-B ve JAXB bağlamasını; ExceptionMapper, ContainerRequestFilter ve @NameBinding'i; AsyncResponse, SSE ve multipart'ı; JWT/OAuth2, CORS, OpenAPI, REST Assured ve dayanıklı istemci tasarımını kapsar.

Süre ve Format

2 Gün. Her gün dört modül; REST Tasarımı ve JAX-RS Temeli; Güvenlik, Asenkron ve İstemci ekseninde ilerleyen uygulamalı program.

Seviye

Orta Seviye — REST ilkeleri, JAX-RS anotasyonları, JSON/XML bağlama, filtre/interceptor, asenkron yanıt, güvenlik ve test

Öğrenme Metodu

Aynı kaynak modeli üzerinde adım adım servis büyütülür; her adım Postman ve REST Assured testleriyle doğrulanır.

Neden Bu Eğitim?

🌐Doğru REST

HTTP yöntemi, durum kodu ve kaynak adlandırma kararlarını standartlara göre verirsiniz.

🧰JAX-RS gücü

Filtre, interceptor ve exception mapper ile temiz bir servis katmanı kurarsınız.

📄Sözleşme

OpenAPI ile belgelenen sürümlenebilir API'ler yayınlarsınız.

Anahtar Konular

JAX-RS eğitimiREST servis JavaJAX-RSRESTful servisExceptionMapperOpenAPIJava REST APIREST AssuredJAX-RS filtreSSE Java

“Güçlü bir REST API, ne kadar az açıklama gerektirirse o kadar iyidir.”

Ön Koşullar

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

1

Java bilgisi

Sınıf, interface, koleksiyon ve istisna kavramlarına temel hakimiyet.

2

Komut satırı

Terminal ve temel Linux/Windows komutları.

3

Geliştirme ortamı

JDK 17+ ve IntelliJ IDEA veya Eclipse kurulu bir bilgisayar.

4

Maven/Git

Maven ile derleme ve temel git bilgisi.

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ı REST ilkelerini uygular, JAX-RS kaynakları yazar ve JSON/XML bağlama ile standart hata gövdeleri üretir.

Modül 1

REST Mimari İlkeleri

REST kısıtları: istemci-sunucu, durumsuzluk, önbellek, tekdüze arayüz
Richardson olgunluk modeli ve HATEOAS
HTTP yöntemleri, idempotency ve güvenli yöntem ayrımı
Durum kodları (200, 201, 204, 400, 401, 403, 404, 409, 422)
Kaynak adlandırma, sürümleme ve sayfalama kuralları
İçerik pazarlığı (Accept/Content-Type) ve koşullu istekler (ETag)

Modül 2

JAX-RS ile Servis Geliştirme

@Path, @GET/@POST/@PUT/@DELETE ve @PathParam/@QueryParam/@HeaderParam
@Produces / @Consumes ile JSON-XML içerik yönetimi
Response ve ResponseBuilder ile durum kodu, header, Location
ExceptionMapper ile hata yanıtlarını standartlaştırma
ContainerRequestFilter, ReaderInterceptor ve @NameBinding
JAX-RS Client API ile servis tüketimi ve asenkron yanıt (@Suspended)

Modül 3

XML ve JSON İşleme

XML ayrıştırma: DOM, SAX, StAX karşılaştırması
JAXB ile Java-XML eşleme ve XSD üretimi
XPath ve XSLT ile sorgu/dönüşüm
JSON-P, JSON-B ve Jackson (ObjectMapper) kullanımı
Jackson annotation'ları: @JsonProperty, @JsonIgnore, polimorfik tipler
Şema doğrulama: XSD ve JSON Schema

Modül 4

Hata Yönetimi, Sürümleme ve Belgeleme

Standart hata gövdesi (RFC 7807 Problem Details)
SOAP Fault ve REST hata eşlemesi
URI/başlık ile sürümleme ve geriye uyumluluk
OpenAPI 3 ile sözleşme belgesi ve kod üretimi
İstek/yanıt günlüğü ve korelasyon kimliği
API yaşam döngüsü ve kullanım dışı bırakma politikası

Günün hedefiKatılımcı kimlik doğrulama ekler, istemciyi dayanıklı yapar, asenkron ve SSE uç noktaları geliştirir ve servisi tamamlar.

Modül 1

Servis Güvenliği ve Test

Basic, API key ve JWT tabanlı kimlik doğrulama
OAuth 2.0 yetkilendirme akışları ve bearer token doğrulama
SecurityContext ve @RolesAllowed kullanımı
CORS ve girdi doğrulama (Bean Validation)
OpenAPI/Swagger ile sözleşme belgeleme
REST Assured, Postman/Newman ile otomatik API testleri

Modül 2

Servis Tüketimi ve Dayanıklılık

JAX-RS Client / Java HttpClient ile servis çağırma
Bağlantı havuzu, zaman aşımı ve yeniden deneme
Circuit breaker ve bulkhead (Resilience4j / MicroProfile Fault Tolerance)
İstemci tarafı önbellek ve ETag
İdempotency anahtarı ve tekrar gönderim güvenliği
Sözleşme testi (Pact) ile tüketici-sağlayıcı uyumu

Modül 3

Asenkron İşlemler, SSE ve Dosya Yönetimi

@Suspended AsyncResponse ve uzun süren işler
Server-Sent Events (SseEventSink) ile anlık bildirim
Multipart dosya yükleme/indirme ve akış (StreamingOutput)
Sayfalama, filtreleme ve içerik sıkıştırma
Zaman aşımı ve iptal yönetimi
ETag, Cache-Control ve koşullu GET

Modül 4

Uçtan Uca Servis Projesi

Alan modeli ve API sözleşmesi tasarımı
Servis, veri erişimi ve doğrulama katmanları
Kimlik doğrulama ve yetkilendirme
Otomatik test paketi (birim + entegrasyon)
Paketleme, dağıtım ve yapılandırma
Sunum ve geri bildirim

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

REST ilkeleri

Kaynak ve yöntem tasarımını standartlara uygun yapabilirsiniz.

🎯

JAX-RS

Path, Produces ve Consumes ile kaynak yazabilirsiniz.

🧩

Veri bağlama

JSON ve XML bağlamasını yapılandırabilirsiniz.

🛠️

Hata yönetimi

ExceptionMapper ile Problem Details üretebilirsiniz.

🔍

Filtreler

Request/response filtreleri yazabilirsiniz.

🚀

Asenkron

AsyncResponse ve SSE kullanabilirsiniz.

📈

Güvenlik

JWT ve OAuth2 ile koruyabilirsiniz.

🧪

Test

REST Assured ve Postman ile test edebilirsiniz.

Kimler İçin Uygundur?

Java
REST API geliştiren ya da SOAP'tan REST'e geçen backend geliştiriciler ve entegrasyon mühendisleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Java ile REST API geliştiren ya da SOAP'tan REST'e geçen backend geliştiriciler ve entegrasyon mühendisleri için uygundur.

Hangi JAX-RS gerçeklemesi kullanılır?

Jersey; RESTEasy ile farklar belirtilir.

Spring MVC ile ilişkisi nedir?

Spring MVC REST ile karşılaştırma yapılır; standartlar ve kavramlar ortaktır.

Maven gerekli mi?

Evet; proje Maven ile derlenir.

Eğitim sonunda sertifika alabilir miyim?

Evet. Devamlılık ve başarı koşullarını yerine getiren katılımcılara 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

PROGRAMMING RESTFUL SERVICES WITH REST/JAX-RS EĞİTİMİ