Enterprise Maven Masterclass · Lehrbuch Edition

Legacy-Refactoring und Migration

Altcode, Monster Methods, Anti-Corruption Layer, Strangler und Migration Report. Dieses Buch ist als Lernseite aufgebaut: erst Überblick, dann fachliches Szenario, danach technische Struktur, Runtime und Vertiefung.

Kategorie: ModernisierungDomäne: LegacyFokus: Wie alte Systeme verstanden, stabilisiert, refactored und migriert werden.

Was lerne ich hier?

Fachlicher Kern

Legacy

Technischer Fokus

Wie alte Systeme verstanden, stabilisiert, refactored und migriert werden.

Warum wichtig?

Altcode, Monster Methods, Anti-Corruption Layer, Strangler und Migration Report.

Lernziel

Du erkennst Zweck, Ablauf, Modulgrenzen und Betriebsbezug dieses Masters.

Fachliches Mini-Szenario

Szenario: Ein Legacy-Datensatz wird gelesen, im Anti-Corruption Layer übersetzt, im modernen Modell validiert und als Migration Report nachvollziehbar dokumentiert.
?

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

Fachlicher AblaufLegacy lesenACLZielmodellMigrationReport
Technischer AblaufREST/APIUse CaseDomainRepositoryOutbox/EventAdapter

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.

⌂ Cockpit