◎
Fachlicher Kern
Integration
Master 17
Master 17 - API & Integration Gateway
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
README · Runnable · Beschreibung · Module · Patterns · SVG-Galerie · Lehrbuch
gateway-core
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
gateway-rest-api
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
contract-catalog
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
event-contracts
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
idempotency
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
correlation
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
routing-policy
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
error-handling
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
integration-demo
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
runnable-smoke
gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Lehrbuch und Praxis
Was lerne ich hier?
⚙
Technischer Fokus
Wie mehrere Systeme über APIs und Events zusammenspielen.
★
Warum wichtig?
API Gateway, Contracts, Correlation-ID, Idempotency und Fehlerantworten.
✓
Lernziel
Du erkennst Zweck, Ablauf, Modulgrenzen und Betriebsbezug dieses Masters.
Fachliches Mini-Szenario
Szenario: Dieser Master zeigt einen fokussierten Lernabschnitt: API Gateway, Contracts, Correlation-ID, Idempotency und Fehlerantworten. Der Ablauf ist so aufgebaut, dass man zuerst Zweck und Kontext versteht, danach Module und Runtime liest und erst anschließend tiefer in Code, Muster und Infrastruktur einsteigt.
?
Fachliche Frage
Welche Geschäftsentscheidung wird hier unterstützt und welche Daten müssen nachvollziehbar bleiben?
?
Technische Frage
Welche Module sind wirklich Fachkern und welche sind nur Adapter, Runtime oder Infrastruktur?
Fachliches und technisches SVG
Die zwei SVGs trennen bewusst Fachlichkeit und Technik. Dadurch sieht man, ob ein Thema wirklich fachlich ist oder nur eine technische Umsetzungsschicht darstellt.
Modulkarte
Domain / Fachmodell
Application / Use Cases
Adapter / Infrastruktur
Runtime / Start
Qualität / Betrieb
Dokumentation / Lernen
Leseregel: Starte immer beim Fachmodell und gehe erst danach in Adapter, Runtime und Plattform. So bleibt die Architektur verständlich.
Start, Runtime und praktische Nutzung
▶
Schnellstart
Öffne RUNNABLE.html oder nutze den Smoke-Start im jeweiligen Workspace.
☕
Spring/Jakarta
Wo vorhanden, ergänzen Spring Boot oder Jakarta eine echte Runtime. Smoke bleibt der robuste Minimalstart.
▣
Container
Bei Container-Mastern helfen Compose, Kubernetes und OpenShift-Profile beim Betriebsverständnis.
mvn -q -pl runnable-smoke -am package exec:java
Was ist Demo, was wäre Produktion?
- Demo: lokale Startbarkeit, vereinfachte Adapter, nachvollziehbare Abläufe.
- Produktionsnah: klare Modulgrenzen, dokumentierte Patterns, Container-/Runtime-Profile und Betriebsdenken.
- Noch zu ergänzen für echte Produktion: echte Secrets, echte Infrastruktur, Security-Härtung, Lasttests und verbindliche Compliance-Vorgaben.
Weiter im Projekt
Diese Links führen aus dem Lehrbuch in die eigentliche Projektstruktur.
Module und Quellcode
10 Module3 KategorienInhalte vollständig übernommen
API & Application 4
correlationAPI & Application
Codepfad:
mvn-ws-impl-api-gw/correlationcorrelation
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
error-handlingAPI & Application
Codepfad:
mvn-ws-impl-api-gw/error-handlingerror-handling
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
idempotencyAPI & Application
Codepfad:
mvn-ws-impl-api-gw/idempotencyidempotency
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
routing-policyAPI & Application
Codepfad:
mvn-ws-impl-api-gw/routing-policyrouting-policy
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
Adapter & Integration 3
gateway-coreAdapter & Integration
Codepfad:
mvn-ws-impl-api-gw/gateway-coregateway-core
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
gateway-rest-apiAdapter & Integration
Codepfad:
mvn-ws-impl-api-gw/gateway-rest-apigateway-rest-api
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
integration-demoAdapter & Integration
Codepfad:
mvn-ws-impl-api-gw/integration-demointegration-demo
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
Testing 3
contract-catalogTesting
Codepfad:
mvn-ws-impl-api-gw/contract-catalogcontract-catalog
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
event-contractsTesting
Codepfad:
mvn-ws-impl-api-gw/event-contractsevent-contracts
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.
runnable-smokeTesting
Codepfad:
mvn-ws-impl-api-gw/runnable-smokerunnable-smoke
Aufgabe: gemeinsames Gateway, REST/Event-Verträge, Correlation und Idempotenz.
Pattern: Adapter, Facade, Strategy.