Seminar Spring Boot 4 – REST-APIs mit Validierung, Fehlerbehandlung und OpenAPI

Einordnung und Nutzen

Das Seminar behandelt REST-APIs als langfristige Verträge zwischen Teams und Systemen. Ressourcenmodell, HTTP-Semantik, Validierung, Fehlerantworten und Versionierung werden vor der Implementierung geklärt und anschließend mit Spring MVC umgesetzt.

OpenAPI, Security, Tests, Idempotenz, Paginierung und Betriebsmetriken werden in denselben Entwicklungsprozess integriert. Ziel ist eine API, die nicht nur im Happy Path funktioniert, sondern Änderungen und Fehlerfälle kontrolliert übersteht.

Inhaltsübersicht

• Einordnung und Nutzen
• Lernziele
• Seminarinhalte
• Praxisübungen
• Zielgruppe und Voraussetzungen
• Didaktik und Arbeitsweise

Lernziele

• Ressourcen und Operationen anhand von HTTP-Semantik entwerfen.
• DTOs, Validierung und konsistente Fehlerantworten implementieren.
• Versionierung, Idempotenz, Paginierung und Filterung vertragssicher gestalten.
• OpenAPI und automatisierte Tests als Qualitätskontrolle nutzen.
• Sicherheit, Performance und Observability in den API-Entwurf aufnehmen.

Seminarinhalte

Tag 1: Ressourcendesign und HTTP-Semantik

1. Fachliche Anwendungsfälle in Ressourcen und Zustandsübergänge übersetzen.
2. GET, POST, PUT, PATCH und DELETE mit korrekter Idempotenz einsetzen.
3. Statuscodes, Header, Content Negotiation und Caching-Grundlagen anwenden.
4. URI-Struktur ohne RPC-artige Aktionssammlung gestalten.
5. Request- und Response-DTOs sowie Mapping definieren.
6. Paginierung, Sortierung und Filterung konsistent modellieren.
7. Versionierungs- und Deprecation-Strategie festlegen.

Tag 2: Validierung, Fehler und Sicherheit

1. Bean Validation für einfache und zusammengesetzte Regeln einsetzen.
2. Fachliche Konflikte von syntaktischen Eingabefehlern trennen.
3. Problemorientierte Fehlerantworten mit stabilen Fehlercodes erstellen.
4. Globale Exception-Behandlung und Logging ohne Datenleck implementieren.
5. Idempotency Key und konkurrierende Änderung für kritische Operationen behandeln.
6. Authentifizierung, Autorisierung, CORS und CSRF passend zum Clientmodell integrieren.
7. Negative und Missbrauchsfälle automatisiert testen.

Tag 3: OpenAPI, Tests und Produktionsqualität

1. OpenAPI-Vertrag mit Beispielen, Fehlern und Security-Schemes pflegen.
2. Vertrag, Implementierung und Tests auf Drift prüfen.
3. Controller-Slices, Integrationstests und Datenbanktests kombinieren.
4. Consumer-orientierte Contract Tests einordnen.
5. Payload-Größe, Serialisierung, Timeouts und Rate Limits messen.
6. Metriken und Traces für Operation, Status und Latenz instrumentieren.
7. Kompatible Änderung und kontrollierte Abschaltung einer alten Version simulieren.

Praxisübungen

• Ressourcenmodell und OpenAPI-Vertrag für einen Bestellprozess entwerfen.
• Validierung, Konflikt und einheitliche Problemantworten implementieren.
• Idempotente Schreiboperation mit konkurrierender Wiederholung testen.
• API-Tests und Kompatibilitätsprüfung in einen Build integrieren.

Zielgruppe und Voraussetzungen

Zielgruppe: Java- und Backend-Entwicklung, API-Design, Integration und technische Architektur.

Voraussetzungen: Gute Java- und Spring-Boot-Grundlagen, HTTP-Verständnis sowie Erfahrung mit automatisierten Tests.

Didaktik und Arbeitsweise

Kurze Fachimpulse werden unmittelbar durch Demonstrationen, strukturierte Implementierungsschritte, Messungen und kontrollierte Fehlerfälle vertieft. Jede Übung enthält einen definierten Ausgangszustand, Prüfpunkte und eine nachvollziehbare Ergebniskontrolle. Die Seminarbeispiele werden in einer durchgängigen Codebasis aufgebaut, damit Zusammenhänge zwischen Konfiguration, Fachlogik, Tests und Betrieb sichtbar bleiben.