Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.


Panel
borderColor#db4b1b
titleColor#ffffff
borderWidth2
titleBGColor#db4b1b
borderStylesolid
titleWichtiger Hinweis

Diese Anleitung gilt für jadice web toolkit Version 5.12.0.0 vom 1231.12.2022.

Die Hinweise gelten für die Migration von jadice web toolkit 5.11 auf 5.12.

Inhalt

Inhalt
maxLevel3

Neue Funktionen und Features

Language Level auf Java 17

Durch die Migration auf Spring Boot 3 / Spring Framework 6 ist es notwendig, das Language Level auf mindestens Java 17 zu heben. Das jadice web toolkit 5.11 ist daher die letzte Version, die mit Java 8 und 11 betrieben werden kann. Diese Version wird von uns mindestens so lange supported, so lange es auch von Spring Fehlerbehebungen für diese Version gibt (nach aktuellem Stand ist dies bis November 2023 der Fall).


Spring Boot 3 & Spring Framework 6

Für die Integration muss ein Upgrade auf Spring Boot 3 stattfinden. Die entsprechenden Schritte sind im Spring Boot 3.0 Migration Guide beschrieben.


JakartaEE

Durch die Migration auf Spring Boot 3 / Spring Framework 6 ist es notwendig, von JavaEE auf JakartaEE zu migrieren.

GWT Core

In den meisten Fällen genügt es, die entsprechenden javax-Imports durch jakarta-Imports zu ersetzen und die entsprechenden Dependencies zu verwenden.

Wenn "Traditional Deployment" verwendet wird, also wenn ein WAR-File auf einem App-Server deployt wird, muss der App-Server JakartaEE kompatibel sein. Eine Liste der unterstützten App-Server finden Sie hier.


GWT Relocation

Es werden jetzt die GWT-Core-Klassen aus dem Package org.gwtproject verwendet, anstatt die Klassen aus dem Package com.google.gwt.

Weitere Informationen hierzu finden Sie hier.


GWT Devmode

Der Devmode über die Dependency gwt-spring-boot-starter hat in vorherigen Versionen so funktioniert, dass die Spring Boot Server Anwendung einen GWT-Codeserver gestartet hat. Dieser hat die Änderungen am Client-Code on-the-fly kompiliert. Diese GWT-Devmode-Dependency ist mit der Migration auf JakartaEE entfallen, da der Devmode von GWT Javax-Packages verwendet und daher nicht weiter kompatibel ist.

Um weiterhin Client-Code debuggen zu können, empfehlen wir das GWT-Plugin von IntelliJ. Bei der Verwendung von Eclipse kann die in gwt-dev enthaltene Klasse com.google.gwt.dev.DevMode manuell gestartet werden.

Der Devmode über das Plugin muss mit den Optionen -war <PFAD ZU /src/main/webapp/> und -noserver gestartet werden.
Dadurch wird eine eigene Server-Anwendung außerhalb des Spring Boot Backends gestartet (-noserver). Zudem wird die vom GWT-Compiler erstellte APPNAME.nocache.js so angepasst, dass die GWT Kompilate über den Devserver geleitet werden, welcher die on-the-fly Kompilierung vornimmt. Damit alles korrekt funktioniert muss der Devmode zuerst gestartet werden und erst im Anschluss die Spring Boot Backend Anwendung.

Ergänzende Informationen können Sie in der Knowledge-Base und GWT-Doku finden.


Bill of Materials (BOM)

Bisher war die Empfehlung die BOM webtoolkit-spring-boot-bom zu verwenden. Da das jadice web toolkit vollständig auf Spring Boot setzt wurde diese BOM zugunsten der BOM webtoolkit-bom aufgegeben.

Verwenden Sie daher fortan webtoolkit-bom in Ihrer Integration.

Weitere Informationen hierzu finden Sie hier.


API-Änderungen und Umbenennungen von Klassen und Packages

altneu

Keine


Anmerkung

Änderungen in der Modulstruktur / Integration via Maven

altneuAnmerkung
webtoolkit-spring-boot-devmode-

Komplett entfernt. Siehe oben.



Entfernte Klassen und Funktionalitäten

BereichFunktion (Klassen)Anmerkung

Keine