Seminar Quarkus API-Entwicklung mit REST, OpenAPI und Validierung

Inhaltsverzeichnis

• Seminarprofil
• Zielgruppe
• Voraussetzungen
• Themen im Überblick
• Praktische Übungen
• Organisatorischer Rahmen

Seminarprofil

Dieses Seminar fokussiert die Entwicklung robuster Web- und Service-Schnittstellen mit Quarkus. Behandelt werden Aufbau, Struktur und Erweiterbarkeit moderner REST-Anwendungen auf Basis der aktuellen Quarkus-REST-Stacks.

Der fachliche Schwerpunkt liegt auf der sauberen Modellierung von Endpunkten, konsistenten Antwortformaten, Bean Validation, Exception Handling, Content Negotiation und der automatisierten Bereitstellung technischer API-Dokumentation.

Der Umfang ist auf zwei Seminartage ausgelegt, weil neben den Grundlagen des REST-Stacks vor allem die praktische Umsetzung mehrerer API-Szenarien mit Tests und Dokumentation ausreichend Übungszeit erfordert.

Zielgruppe

Geeignet ist das Seminar für Java-Entwicklungsteams, die mit Quarkus serviceorientierte Backends, interne Fach-APIs oder öffentlich konsumierbare Schnittstellen entwickeln. Ebenso passend ist das Format für Teams, die bestehende REST-Standards aus Spring Boot oder Jakarta EE in eine Quarkus-Umgebung übertragen möchten.

Voraussetzungen

Vorausgesetzt werden sichere Java-Grundkenntnisse, Erfahrung mit Maven sowie ein grundlegendes Verständnis von HTTP, JSON und typischen API-Konzepten. Vorwissen in Quarkus ist hilfreich, aber nicht zwingend, sofern bereits Erfahrung mit serverseitiger Java-Entwicklung vorhanden ist.

Themen im Überblick

• Aufbau von Ressourcen, Endpunkten, Pfaden, Parametern und Payloads mit Quarkus REST
• Arbeiten mit JSON, Serialisierung, DTOs und klaren Response-Strukturen
• Validierung von Eingaben mit Bean Validation und fachlich sauberen Fehlermeldungen
• Zentrale Fehlerbehandlung, Statuscodes und Exception Mapper
• OpenAPI-Definitionen, Dokumentation und Strukturierung größerer API-Landschaften
• REST-Clients, Timeouts, Fehlerbilder und Weitergabe technischer Metadaten
• Grundlagen für Security-Anbindung, Token-Nutzung und API-Schutz
• Testen von Endpunkten, Request-Flows und typischen Negativfällen

Praktische Übungen

Die Übungen bauen eine vollständige Quarkus-API mit mehreren Ressourcen, Validierungsregeln, standardisierten Fehlerrückgaben und generierter Dokumentation auf. Dabei werden sowohl klassische CRUD-Szenarien als auch fachlich anspruchsvollere Request- und Response-Muster umgesetzt.

Zusätzlich werden Client-Aufrufe gegen externe Services, Testfälle für erfolgreiche und fehlerhafte Requests sowie die technische Vorbereitung für spätere Security- und Datenzugriffserweiterungen Schritt für Schritt integriert.

Organisatorischer Rahmen

Das Seminar ist auf 2 Tage ausgelegt. Der Zeitrahmen wurde so gewählt, dass Theorie, Architekturverständnis, praktische Umsetzung und Diskussion typischer Projektsituationen in einem fachlich sauberen Verhältnis stehen.