REST Assured: Raporlama Entegrasyonu

Eğitim Hakkında

REST Assured test sonuçlarının Allure ve ExtentReports ile raporlanması ve CI hattında yayınlanması

Bu eğitim, REST Assured testlerinin sonuçlarını paydaşlara anlaşılır biçimde sunmayı öğretir. Allure ile @Step, @Feature, @Story ek açıklamaları, AllureRestAssured filtresi, allure-results ve allure serve, trend grafikleri; ExtentReports ile HTML rapor ve kategori; Surefire ve JUnit XML çıktıları işlenir. Hatalı testte istek/yanıt günlüğü ekleme, hassas bilgi maskeleme, Jenkins ve GitHub Actions üzerinde rapor yayınlama, Slack bildirimi ve WireMock ile kararlı test ortamı uygulanır.

Süre ve Format

2 Gün. Her gün dört modül; katılımcılar Test Yazımı ve Raporlama Temeli → Gelişmiş Raporlama ve CI sırasıyla ilerler.

Seviye

Orta Seviye — REST Assured test sonuçlarının Allure ve ExtentReports ile raporlanması ve CI hattında yayınlanması.

Öğrenme Metodu

Katılımcılar mevcut test paketine Allure ve Extent raporları ekler, CI hattında yayınlar ve hata raporlarını inceler.

Neden Bu Eğitim?

📊Anlaşılır Rapor

Test sonuçlarını teknik olmayan paydaşların da okuyabileceği hale getirirsiniz.

🔎Hızlı Teşhis

İstek ve yanıtı rapora ekleyerek hata nedenini dakikalar içinde bulursunuz.

📣Otomatik Bildirim

CI üzerinden rapor ve Slack bildirimiyle takımı bilgilendirirsiniz.

Anahtar Konular

Allure raporExtentReportsREST Assured raporlamatest raporuJenkins AllureGitHub Actions raporSurefireAPI test raporuCI test raporuREST Assured eğitimi

“Raporlanmayan test, yapılmamış test kadar sessizdir.”

Ön Koşullar

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

1

Java Temelleri

Sınıf, metot, koleksiyon ve generics konularında temel Java bilgisi gerekir.

2

HTTP ve JSON

HTTP metotları, durum kodları ve JSON yapısına aşinalık beklenir.

3

Maven ve IDE

Maven bağımlılık yönetimi ve IntelliJ IDEA veya Eclipse kullanımına genel hakimiyet faydalıdır.

4

Çalışma Ortamı

JDK 17+, Maven ve internet erişimi olan bir dizüstü bilgisayar hazır bulunmalı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ı REST Assured projesini Maven ile kurar ve given/when/then kalıbıyla ilk testleri yazar, Hamcrest ve Matchers ile koleksiyon, metin ve sayısal doğrulamalar yazar, RequestSpecification, ResponseSpecification ve katmanlı test çatısı tasarlar ve REST Assured testlerini Allure ve ExtentReports ile raporlar, CI hattına bağlar.

Modül 1

REST Assured ile İlk Testler

Maven bağımlılıkları: rest-assured, JUnit 5 veya TestNG ve hedef Java sürümü yapılandırması
given() / when() / then() söz dizimi ve BDD tarzı okunabilir test cümleleri
RestAssured.baseURI, basePath ve port ayarlarıyla ortama göre hedef belirleme
GET isteğiyle durum kodu, Content-Type ve gövdeden alan okuma (extract().path())
log().all(), log().ifValidationFails() ile istek ve yanıtın günlüklenmesi
Test API'si olarak JSON Server veya ReqRes kullanımı ve ilk test sınıfının çalıştırılması

Modül 2

Hamcrest Eşleştiricileri ile Yanıt Doğrulama

equalTo, not, nullValue, notNullValue ve is() ile temel eşleştiriciler
hasItem, hasItems, hasSize, containsInAnyOrder, everyItem ile liste doğrulamaları
startsWith, containsString, matchesPattern ile metin ve düzenli ifade doğrulaması
greaterThan, lessThanOrEqualTo, closeTo ile sayısal ve ondalık aralık kontrolleri
allOf, anyOf ve özel (custom) TypeSafeMatcher yazarak yeniden kullanılabilir doğrulama
Doğrulama başarısızlık mesajlarını okuma ve anlamlı hata açıklaması üretme

Modül 3

REST Assured Test Mimarisi ve Yapılandırma

RequestSpecBuilder ve ResponseSpecBuilder ile ortak başlık, taban URL ve beklentilerin merkezi tanımı
Page Object benzeri API istemci sınıfları (service object) ve test verisi oluşturucular (builder)
Ortam yapılandırması: properties/YAML dosyaları, Maven profilleri ve sistem özellikleri
Filter arayüzü ile istek/yanıt kesme, token yenileme ve özel günlükleme
Test verisi yönetimi: @BeforeAll/@AfterEach ile oluştur-sil döngüsü ve bağımsız testler
Paralel çalıştırma, JUnit 5 etiketleri (tag) ve duman/regresyon paketlerinin ayrıştırılması

Modül 4

Allure ve ExtentReports ile Test Raporlama

Allure ile @Step, @Feature, @Story ek açıklamaları ve AllureRestAssured filtresi
Allure sonuç dizini (allure-results), allure serve ve trend/geçmiş grafikleri
ExtentReports ile HTML rapor, test kategorileri ve hata ekran/yük ekleme
Surefire/Failsafe raporları ve JUnit XML çıktısının CI araçlarında okunması
Jenkins veya GitHub Actions üzerinde rapor yayınlama (artifact, Pages) ve Slack bildirimi
Hatalı testlerde istek/yanıt günlüğünün rapora eklenmesi ve gizli bilgilerin maskelenmesi

Günün hedefiKatılımcı GPath ile JSON ayrıştırır ve JSON Schema Validator ile şema doğrular, Hatalı yanıtları, zaman aşımını ve bozuk veriyi simüle ederek dayanıklılık testi yazar, Newman ile koleksiyonları CI hattında çalıştırır, mock server ve monitör kurar ve WireMock ile stub, eşleştirme ve doğrulama yaparak dış bağımlılıkları taklit eder.

Modül 1

JSON Yanıt ve Şema Doğrulama

JsonPath / GPath ifadeleri: data.items[0].id, findAll, collect, sum, max
İç içe dizilerde filtreleme: items.findAll { it.price > 100 }.name
json-schema-validator modülü ile matchesJsonSchemaInClasspath kullanımı
JSON Schema Draft-07 anahtarları: required, type, format, additionalProperties, minItems
Yanıtı POJO'ya eşleme (as(Class)) ve nesne düzeyinde assertJ doğrulaması
Şema sürüm değişikliğinde kırıcı değişiklikleri yakalayan sözleşme testi stratejisi

Modül 2

Hata Yönetimi ve Hata Enjeksiyonu Testleri

Negatif test kataloğu: 400, 401, 403, 404, 409, 422 ve 500 yanıtlarının doğrulanması
HttpClientConfig ile bağlantı ve okuma zaman aşımı (connection/socket timeout) ayarları
WireMock fault tipleri: CONNECTION_RESET_BY_PEER, EMPTY_RESPONSE, MALFORMED_RESPONSE_CHUNK
Gecikme enjeksiyonu (fixedDelay, lognormal) ile yavaş bağımlılık davranışı
Yeniden deneme (retry) mantığı için senaryo tabanlı durum geçişi (scenario state)
Sınır değer, aşırı büyük gövde, geçersiz Unicode ve SQL/JSON enjeksiyonu benzeri bozuk girdi testleri

Modül 3

Newman, CI/CD ve Mock Server

Newman kurulumu ve newman run komutu: -e, -d, --iteration-count, --bail seçenekleri
htmlextra ve JUnit raporlayıcıları ile test sonuçlarının üretilmesi
GitHub Actions veya Jenkins hattına Newman adımı ekleme ve başarısız testte derlemeyi durdurma
Postman Mock Server ile örnek yanıtlardan sahte servis oluşturma
Postman Monitors ile zamanlanmış kontrol ve uyarı yapılandırması
Gizli bilgilerin (API anahtarı) CI ortam değişkeni veya vault ile koleksiyona verilmesi

Modül 4

WireMock ile API Taklit (Mocking)

WireMock bağımsız sunucu ve JUnit 5 uzantısı (@WireMockTest) ile başlatma
stubFor, urlPathEqualTo, withQueryParam, withHeader ve withRequestBody ile istek eşleştirme
willReturn ile statik gövde, __files dizini ve Handlebars yanıt şablonları
verify(postRequestedFor(...)) ile çağrı doğrulaması ve zaman sayacı
Kayıt/oynatma (record & playback) ile gerçek servis yanıtlarından stub üretme
Senaryolar (scenarios) ile durumlu servis simülasyonu ve proxy ile kısmi taklit

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

REST Assured Başlangıç

given/when/then kalıbıyla çalışan ilk REST Assured testlerini yazıp çalıştırabilirsiniz.

🧩

Hamcrest Doğrulama

Hamcrest eşleştiricileriyle koleksiyon ve metin doğrulamalarını okunabilir biçimde yazabilirsiniz.

🛠️

Test Mimarisi

Yeniden kullanılabilir spesifikasyonlarla bakımı kolay bir API test çatısı kurabilirsiniz.

🔐

Test Raporlama

Allure veya ExtentReports ile istek/yanıt detaylı test raporları üretip CI'da yayınlayabilirsiniz.

📈

JSON ve Şema

GPath ile JSON alanlarını doğrulayıp JSON Schema ile sözleşme testi yazabilirsiniz.

🧪

Hata Enjeksiyonu

Zaman aşımı, 5xx ve bozuk yanıt senaryolarını test edip hata işleme davranışını doğrulayabilirsiniz.

🚀

Newman ve CI

Newman ile Postman testlerini CI hattında raporlu şekilde çalıştırabilirsiniz.

🔎

WireMock

WireMock stub'ları ile dış servis bağımlılıklarını izole edip kararlı testler yazabilirsiniz.

Kimler İçin Uygundur?

REST Assured
test yazan QA mühendisleri ve test sonuçlarını yönetime raporlamak zorunda olan test liderleri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

REST Assured ile test yazan QA mühendisleri ve test sonuçlarını yönetime raporlamak zorunda olan test liderleri için uygundur.

Allure ve Extent arasında hangisi seçilmeli?

İkisi de uygulanır ve ekip ihtiyacına göre karşılaştırılır; Allure daha zengin geçmiş ve trend sunar.

Rapor nerede yayınlanır?

Jenkins publisher, GitHub Pages ve artifact olarak yayınlama örnekleri verilir.

Gizli veriler raporda görünür mü?

Hayır, istek ve yanıt günlüklerinde maskeleme uygulaması gösterilir.

Eğitim sonunda sertifika verilir mi?

Eğitimi tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir. Üçüncü taraf kurumların sınav ve sertifikalarıyla bir bağı yoktur.

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

REST ASSURED TECHNIQUES: INTEGRATING REPORTING WITH REST ASSURED API TESTING EĞİTİMİ