Seminar Spring Boot – REST APIs und Webanwendungen

Inhaltsverzeichnis

• Seminarprofil
• Lernziele
• Schwerpunkte
• Praxisübungen
• Zielgruppe und Vorkenntnisse

Seminarprofil

Eine stabile API erfordert mehr als Controller-Annotationen. Dieses Seminar verbindet HTTP-Semantik, Ressourcenmodell, Datenverträge, Validierung, Fehlerbehandlung und Versionierungsentscheidungen mit der konkreten Implementierung in Spring Boot und Spring MVC.

Behandelt werden synchrone Webanwendungen, JSON-Verarbeitung, Datei- und Streamingfälle, zentrale Querschnittsfunktionen, API-Tests und HTTP-Clients. Die Beispielanwendung wird so aufgebaut, dass interne Domänenmodelle nicht unkontrolliert zur öffentlichen Schnittstelle werden.

Lernziele

• REST-Ressourcen und HTTP-Operationen konsistent modellieren
• Controller, Datenbindung und JSON-Verträge sauber implementieren
• Validierung und zentrale Fehlerantworten mit Problem Details aufbauen
• Versionierung, Pagination, Filterung und Nebenläufigkeit gestalten
• Webschnittstellen mit Security-Basis und Querschnittsfunktionen absichern
• APIs mit MockMvc, Test Clients und Integrationstests prüfen
• Externe HTTP-Dienste über moderne Clients zuverlässig anbinden

Schwerpunkte

HTTP und Ressourcenmodell

• Methoden, Statuscodes, Header, Content Negotiation und Idempotenz
• Ressourcen, Unterressourcen und URI-Entwurf
• Caching, Conditional Requests und ETags

Spring MVC und Controller

• Request Mapping, Parameter, Pfade und Bodies
• DTOs, Mapping und Trennung vom Persistenzmodell
• ResponseEntity, Header und Dateidownloads

Validierung und Fehlerbehandlung

• Bean Validation für Request- und Domänenregeln
• Zentrale Exception Handler und Problem Details
• Konsistente Fehlercodes, Felder und Korrelationsinformationen

API-Design für Änderungen

• Versionierungsstrategien und Kompatibilitätsregeln
• Pagination, Sorting, Filterung und Suchparameter
• Optimistische Nebenläufigkeit und Konfliktantworten

Querschnittsfunktionen

• Filter, Interceptors und Request-Kontext
• CORS, Security-Grundlagen und Eingabegrenzen
• Logging, Metriken und Tracing für HTTP-Pfade

HTTP-Clients und Integration

• RestClient, HTTP Service Clients und WebClient-Einordnung
• Timeouts, Fehlerabbildung und Resilience
• SSRF-Schutz und kontrollierte Zieladressen

Tests und Dokumentation

• Controller-Unit- und Slice-Tests
• MockMvc, RestTestClient beziehungsweise WebTestClient
• Vertragsorientierte API-Dokumentation aus Tests

Praxisübungen

1. Ein Ressourcenmodell und die zugehörigen HTTP-Operationen für einen Geschäftsfall entwerfen.
2. Controller und DTOs mit klarer Trennung vom Persistenzmodell implementieren.
3. Validierung und ein zentrales Problem-Details-Fehlerformat ergänzen.
4. Pagination, Filterung und optimistische Konfliktbehandlung umsetzen.
5. CORS, Request-Korrelation und technische Metriken konfigurieren.
6. Einen externen Dienst über einen typisierten HTTP-Client mit Timeout und Fehlerabbildung anbinden.
7. API-Verhalten über Slice- und Integrationstests automatisiert dokumentieren und prüfen.

Zielgruppe und Vorkenntnisse

Zielgruppe: Java- und Spring-Entwicklung, Backend-Entwicklung, API-Entwicklung und Softwarearchitektur.

Vorkenntnisse: Gute Java- und Spring-Boot-Grundkenntnisse sowie Basiswissen zu HTTP und JSON. Datenbankkenntnisse sind für die Übungen hilfreich.