Seminar Micronaut – Serialization, Validation und API-Verträge

Stabile API-Verträge hängen von kontrollierten Datenmodellen, Formaten und Fehlermeldungen ab. Das Seminar verbindet Micronaut Serialization, Bean Validation, eigene Constraints, Kompatibilitätsregeln und automatisierte Vertragstests in einem kompakten Praxistag.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

• Ein- und Ausgabemodelle unabhängig vom Persistenzmodell entwerfen
• Serialisierungsformate, Nullwerte, Enums und unbekannte Felder kontrollieren
• Bean Validation und fachliche Prüfungen in eindeutiger Reihenfolge anwenden
• API-Kompatibilität und Fehlerformate automatisiert testen

Zielgruppe

Backend- und API-Entwickler, Integrationsentwickler, Softwarearchitekten und technische Leads.

Voraussetzungen

Gute Java- oder Kotlin-Kenntnisse, Micronaut-Grundlagen sowie sicheres Verständnis von HTTP, JSON und automatisierten Tests.

Seminarinhalte

1. Schritt 1: Vertragsmodelle abgrenzen

   Request-, Response-, Domain- und Persistence-Modelle werden nach Verantwortlichkeit getrennt. Unbeabsichtigte Veröffentlichung interner Felder wird verhindert.

2. Schritt 2: Serialisierung konfigurieren

   Feldnamen, Datums- und Zahlenformate, Nullwerte, Enums, Collections, unbekannte Felder und Sichtbarkeit werden anhand eines expliziten Vertrags festgelegt.

3. Schritt 3: Unveränderliche und polymorphe Modelle behandeln

   Records, Datenklassen, Builder, Sealed Types und kontrollierte Typinformationen werden sicher abgebildet.

4. Schritt 4: Bean Validation einsetzen

   Pflichtwerte, Grenzen, Muster, verschachtelte Objekte, Gruppen und methodenbezogene Validierung werden für Eingaben und Konfiguration angewendet.

5. Schritt 5: Eigene Constraints entwickeln

   Fachlich wiederkehrende Prüfungen werden als Constraint und Validator umgesetzt. Datenbankzugriffe und Seiteneffekte bleiben außerhalb einfacher Validierung.

6. Schritt 6: Fehlerformat vereinheitlichen

   Feldpfad, Code, Meldung, abgelehnter Wert, Korrelation und fachliche Fehler werden in einem stabilen Response-Schema zusammengeführt.

7. Schritt 7: Kompatibilität testen

   Additive und brechende Änderungen, Golden Files, Schema- beziehungsweise OpenAPI-Vergleich und Consumer-Erwartungen werden automatisiert geprüft.

Praxisübungen

• DTO-Entwurf mit getrennten Modellen
• Eigener Cross-Field-Validator
• Maschinenlesbares Validierungsfehlerformat
• Regressionstest für Payload-Änderungen

Methodik

Kurze fachliche Einordnungen wechseln mit Demonstrationen und schrittweisen Übungen. Jeder Arbeitsstand wird gebaut, ausgeführt und durch automatisierte oder betriebliche Prüfungen abgesichert. Fehlerfälle werden bewusst einbezogen, damit Diagnose und Wiederanlauf nicht erst im Produktivbetrieb entstehen.