{"id":38479,"date":"2023-12-27T14:51:26","date_gmt":"2023-12-27T13:51:26","guid":{"rendered":"https:\/\/www.happycoders.eu\/?p=38479"},"modified":"2025-06-12T08:54:18","modified_gmt":"2025-06-12T06:54:18","slug":"hexagonale-architektur-spring-boot","status":"publish","type":"post","link":"https:\/\/www.happycoders.eu\/de\/software-craftsmanship\/hexagonale-architektur-spring-boot\/","title":{"rendered":"Hexagonale Architektur mit Spring Boot [Tutorial]"},"content":{"rendered":"\n

In diesem letzten Teil der Tutorial-Serie zeige ich dir, wie wir die Anwendung, die wir im Laufe dieses Tutorials \u2013 zun\u00e4chst ohne Framework \u2013 nach der hexagonalen Architektur entwickelt und dann auf Quarkus umgestellt haben, auf das Spring-Boot-Framework migrieren.<\/p>\n\n\n\n

R\u00fcckblick<\/h2>\n\n\n\n

Wir haben diese Artikelserie mit den Grundlagen der hexagonalen Architektur<\/a> begonnen.<\/p>\n\n\n\n

Danach haben wir eine Java-Anwendung mit der hexagonalen Architektur<\/a> entwickelt \u2013 zun\u00e4chst ohne ein Application Framework. Anschlie\u00dfend haben wir die Anwendung um einen JPA-Adapter erweitert<\/a>, um die Daten in einer Datenbank zu persistieren anstatt sie lediglich im Arbeitsspeicher zu halten. Im vorangegangenen Teil der Serie haben wir dann die hexagonale Anwendung in Quarkus<\/a> als Application Framework eingebettet.<\/p>\n\n\n\n

Alle Erweiterungen der Anwendung \u2013 sowohl die Anbindung eines neuen Adpaters als auch die Migration zu Quarkus \u2013 konnten wir durchf\u00fchren, ohne auch nur eine Zeile Code im Anwendungskern \u00e4ndern zu m\u00fcssen.<\/p>\n\n\n\n

Die folgende Grafik zeigt die Architektur unserer Anwendung. Der zuvor erw\u00e4hnte Anwendungskern wird durch das mit \u201eApplication\u201d bezeichnete Hexagon dargestellt:<\/p>\n\n\n

\n
\"Hexagonale<\/figure>\n<\/div>\n\n\n

Den aktuellen Stand der Demo-Anwendung findest du im \u201ewith-quarkus\u201d-Branch dieses GitHub-Repositories<\/a>.<\/p>\n\n\n\n

Worum geht es in diesem Teil? <\/h2>\n\n\n\n

In diesem f\u00fcnften und letzten Teil der Serie werden wir unsere Anwendung von Quarkus<\/a> zu Spring Boot<\/a> migrieren \u2013 und auch das wieder, ohne Code im Anwendungskern \u00e4ndern zu m\u00fcssen.<\/p>\n\n\n\n

Wir werden dabei wieder schrittweise vorgehen wie bei der Migration zu Quarkus. Doch da Spring sowohl bei den prim\u00e4ren als auch bei den sekund\u00e4ren Controllern andere Technologien einsetzt (Spring Web MVC<\/a> anstelle von Jakarta RESTful Web Services<\/a> im Frontend und Spring Data JPA<\/a> anstelle von Panache<\/a> im Backend), wird die Anwendung zwischen den Schritten nicht kompilierbar und lauff\u00e4hig sein, sondern erst nach Abschluss der Migration.<\/p>\n\n\n\n

Wir werden die Anwendung in folgenden Schritten zu Spring Boot migrieren:<\/p>\n\n\n\n

    \n
  1. Zuerst werden wir die Quarkus-Dependencies in den pom.xml<\/em>-Dateien durch Spring-Boot-Dependencies ersetzen.<\/li>\n\n\n\n
  2. Dann werden wir die prim\u00e4ren REST-Adapter anpassen, indem wir die JAX-RS-Annotationen durch Spring-Web-MVC-Annotationen ersetzen.<\/li>\n\n\n\n
  3. Danach werden wir die sekund\u00e4ren Persistenzadapter migrieren, indem wir die Panache-Repositories durch Spring-Data-JPA-Repositories ersetzen. Dabei werden wir auch die Annotationen austauschen, die kontrollieren, welche Adapter (In-Memory oder JPA) erzeugt werden.<\/li>\n\n\n\n
  4. Dann werden wir die Quarkus-Anwendungskonfiguration im adapter<\/em>-Modul durch eine Spring-Boot-Konfiguration ersetzen, woraufhin das adapter<\/em>-Modul wieder kompilierbar sein wird.<\/li>\n\n\n\n
  5. Zuletzt werden wir eine Spring-Boot-Starter-Klasse hinzuf\u00fcgen und die End-to-End-Tests im bootstrap<\/em>-Modul anpassen.<\/li>\n<\/ol>\n\n\n\n

    Den Stand des Codes nach Abschluss der Migration findest du im \u201ewith-spring-boot\u201d-Branch<\/a> des GitHub-Repositories. Alle \u00c4nderungen gegen\u00fcber der Quarkus-Version findest du in diesem Pull Request<\/a>.<\/p>\n\n\n\n

    Beginnen wir mit Schritt 1...<\/p>\n\n\n\n

    Schritt 1: Dependencies austauschen<\/h2>\n\n\n\n

    Ausgehend vom Projektstand im \u201ewith-quarkus\u201d-Branch<\/a> werden wir in den pom.xml<\/em>-Dateien des Projekts die Quarkus-Bill-of-Materials durch den Spring-Boot-Starter-Parent und alle Quarkus-Dependences durch Spring-Boot-Dependencies ersetzen.<\/p>\n\n\n\n

    Anpassung der Eltern-pom.xml<\/h3>\n\n\n\n

    Um die Versionen aller Spring-Boot-Bibliotheken verf\u00fcgbar zu haben, f\u00fcgen wir als erstes in die pom.xml<\/em> des Projektverzeichnisses den Spring-Boot-Starter-Parent ein, z. B. zwischen <modelVersion><\/code> und <groupId><\/code>:<\/p>\n\n\n

    <parent<\/span>><\/span>\n    <groupId<\/span>><\/span>org.springframework.boot<\/groupId<\/span>><\/span>\n    <artifactId<\/span>><\/span>spring-boot-starter-parent<\/artifactId<\/span>><\/span>\n    <version<\/span>><\/span>3.1.5<\/version<\/span>><\/span>\n<\/parent<\/span>><\/span>\n<\/code><\/span>Code-Sprache:<\/span> HTML, XML<\/span> (<\/span>xml<\/span>)<\/span><\/small><\/pre>\n\n\n
    Alle Quarkus-spezifischen Eintr\u00e4ge k\u00f6nnen wir dann entfernen:<\/p>\n\n\n\n