Seminar Micronaut REST APIs und HTTP-Clients

Dieses Seminar konzentriert sich auf REST-Schnittstellen und HTTP-Clients in Micronaut. Behandelt werden API-Design, Controller, Validierung, Fehlerantworten, deklarative Clients und Schnittstellentests. Zwei Tage sind ausreichend, weil der Fokus klar auf HTTP-Kommunikation liegt und Datenbank- oder Plattformthemen nur am Rand vorkommen.

Inhaltsübersicht

• REST-Design und Ressourcenmodellierung
• Controller, DTOs, Validierung und Fehlerbehandlung
• Deklarative HTTP-Clients und externe Services
• Timeouts, Fehlerszenarien und Wiederverwendbarkeit
• API-Tests und Vertragsstabilität

Zielgruppe

Java-Backend-Entwicklung, API-Entwicklung, Integrationsentwicklung, technische Consultants.

Voraussetzungen

Java-Grundkenntnisse, HTTP- und REST-Grundlagen, Basiswissen zu JSON und API-Tests.

Seminarinhalte

REST-Schnittstellen modellieren

1. Ressourcen und Operationen anhand fachlicher Anwendungsfälle definieren.
2. HTTP-Methoden, Statuscodes und Antwortstrukturen konsistent einsetzen.
3. DTOs für Eingabe und Ausgabe trennen.
4. Validierungsregeln nahe an den Eingabemodellen verankern.

Controller und Fehlerbehandlung implementieren

1. Controller schlank halten und Fachlogik in Services auslagern.
2. Validierungsfehler und fachliche Fehler sauber unterscheiden.
3. Einheitliche Fehlerantworten für Clients bereitstellen.
4. Randfälle wie leere Ergebnisse, Konflikte und fehlerhafte IDs testen.

HTTP-Clients einsetzen

1. Deklarative Clients für interne oder externe Services definieren.
2. Basis-URLs, Timeouts und Umgebungen über Konfiguration steuern.
3. Fehlerantworten externer Services gezielt behandeln.
4. Schnittstellentests mit simulierten Gegenstellen erstellen.

Praktische Übungen

1. Implementierung einer REST-API mit Validierung und Fehlerantworten.
2. Erstellung eines deklarativen HTTP-Clients für einen zweiten Service.
3. Test von Erfolgs-, Validierungs- und Fehlerfällen.
4. Refactoring einer unklaren API-Struktur in ein konsistentes Ressourcenmodell.

Methodik

Die Inhalte werden als Wechsel aus kurzer fachlicher Einordnung, Demonstration, geführter Implementierung und eigenständiger Übung aufgebaut. Jede technische Entscheidung wird im Kontext wartbarer Java- und JVM-Projekte betrachtet.