Jakarta EE 9: Der große Umzug von javax zu jakarta

Keine Zeit? Hier die Kurzversion in 30 Sekunden.
- Jakarta EE 9 erschien am 8. Dezember 2020 und bringt im Kern nur eine Änderung: Aus
javax.wirdjakarta..- Neue Funktionen gibt es nicht. Die Basis bleibt Java 8, Java 11 soll mit einer Version 9.1 folgen.
- Umgesetzt ist das in GlassFish 6, Apache Tomcat 10 und Eclipse Jetty 11.
- Das eigentliche Problem sind gemischte Abhängigkeiten, bei denen Bibliotheken noch das alte Paket erwarten.
- Ich würde früh inventarisieren und testen, aber nicht blind umstellen, bevor die wichtigsten Bibliotheken so weit sind.
Selten war ein Release so langweilig und gleichzeitig so folgenreich wie dieses. Jakarta EE 9 ist am 8. Dezember erschienen, und die Liste der neuen Funktionen ist, nun ja, kurz. Genauer gesagt: Es gibt keine. Der ganze Inhalt besteht darin, dass Paketnamen umbenannt wurden. Aus javax.servlet wird jakarta.servlet, aus javax.persistence wird jakarta.persistence, und so weiter durch die gesamte Plattform.
Wer jetzt denkt, das sei doch nur ein Suchen und Ersetzen, hat damit zur Hälfte recht. Warum die andere Hälfte das Eigentliche ist, möchte ich hier aufschreiben. Und weil ich 2018 in „Aus Java EE wird Jakarta EE“ noch geschrieben habe, dass die Frage nach den Paketnamen offen sei, ist das auch ein Stück Auflösung einer Geschichte, die ich damals schon mitverfolgt habe.
Wie es dazu kam
Kurz zur Erinnerung. Oracle hat Java EE an die Eclipse Foundation übergeben, dort heißt es seitdem Jakarta EE. Die Namensrechte an „Java“ und die Pakete unter javax blieben aber ein Streitpunkt. Im Mai 2019 wurde klar, dass Oracle der Eclipse Foundation nicht erlaubt, die Plattform weiterhin unter dem Namensraum javax weiterzuentwickeln. Bestehende Spezifikationen durften bleiben, wie sie sind, Änderungen am Inhalt dagegen nicht ohne Umbenennung.
Daraus ergab sich ein Dilemma, das man so zusammenfassen kann: Entweder man friert javax ein und entwickelt nirgends mehr weiter, oder man baut einen sauberen Schnitt. Die Community hat sich nach einigem Hin und Her für den Schnitt entschieden. Jakarta EE 8 vom September 2019 war inhaltlich noch Java EE 8, nur unter neuem Dach und mit alten Paketnamen. Jakarta EE 9 ist der Schritt, bei dem der Namensraum wechselt.
Ich finde, das war die vernünftigste Lösung. Sie ist unbequem, aber ehrlich, und sie vermeidet einen Dauerzustand, in dem die Plattform ihren eigenen Namen nicht tragen darf.
Was in Jakarta EE 9 drin ist, und was nicht
Der Umfang ist schnell erzählt. Alle Spezifikationen der Plattform wechseln von javax. auf jakarta.. Es kommen keine neuen Funktionen hinzu. Die Basis ist weiter Java 8, Unterstützung für Java 11 ist für eine Folgeversion 9.1 vorgesehen. Einige alte Spezifikationen, die kaum noch jemand benutzt hat, wurden entfernt, darunter XML Registries, Deployment und Management.
Das war bewusst so gewollt. Man hat die Umbenennung von allem anderen getrennt, damit Hersteller und Projekte genau eine Sache auf einmal umsetzen müssen. Neue Funktionen kommen dann in den Versionen danach. Als Entscheidung finde ich das nachvollziehbar, auch wenn es sich nach einem Release ohne Inhalt anfühlt.
Wichtig: Nicht alles, was javax heißt, zieht um. Pakete, die zum JDK selbst gehören, bleiben, wo sie sind. Dazu zählen zum Beispiel javax.sql, javax.crypto oder javax.net. Wer pauschal alles ersetzt, was mit javax anfängt, richtet Schaden an.
Wer es schon kann
Auf der Seite der Implementierungen sind die ersten Produkte schon da:
- GlassFish 6 ist die Referenzimplementierung für Jakarta EE 9.
- Apache Tomcat 10 setzt Servlet 5.0 um und damit den neuen Namensraum. Tomcat 9 bleibt bei
javax.servlet. - Eclipse Jetty 11 zieht ebenfalls um.
Bei Tomcat finde ich besonders aufschlussreich, dass die alte und die neue Version nebeneinander gepflegt werden. Eine Webanwendung, die für Tomcat 9 gebaut ist, läuft auf Tomcat 10 nicht einfach so weiter, weil die Servlet-Klassen schlicht anders heißen. Das ist ein harter Bruch auf Binärebene, nicht nur eine kosmetische Änderung im Quelltext.
Das eigentliche Problem: gemischte Abhängigkeiten
Eine Anwendung selbst umzustellen, ist selten das Schwierige. Man ersetzt die Importe, baut neu, testet, fertig:
// vorher
import javax.servlet.http.HttpServlet;
import javax.persistence.Entity;
// nachher
import jakarta.servlet.http.HttpServlet;
import jakarta.persistence.Entity;Das Schwierige sind die Bibliotheken, die man einbindet. Jede Bibliothek, die gegen javax.servlet oder javax.persistence gebaut wurde, passt nicht mehr zu einem Server, der jakarta.servlet erwartet. Und umgekehrt. Man steht vor einem Graphen aus Abhängigkeiten, in dem jede Kante entweder alt oder neu sein muss, und gemischt funktioniert es nicht. Ein einzelnes Framework, das noch auf javax steht, kann die ganze Umstellung blockieren.
Für Bibliotheksautoren ist es noch unangenehmer. Sie müssen entweder zwei Artefakte anbieten, eines für den alten und eines für den neuen Namensraum, oder sich für eine Seite entscheiden und einen Teil der Nutzer zurücklassen. Beides kostet Aufwand, und beides erzeugt Verwirrung in Versionsnummern und Dokumentation.
Auch bei den großen Frameworks sehe ich das. Spring hat meines Wissens noch nicht umgestellt. Ich nenne hier bewusst keinen Termin, weil ich keinen kenne, und ich würde jedem raten, Terminen aus zweiter Hand nicht zu trauen.
Werkzeuge, die helfen können
Es gibt einen Ansatz, der das Problem ein Stück weit abfedert: Man schreibt fertigen Code nachträglich um. Das Projekt Eclipse Transformer kann Bytecode, aber auch ganze Archive wie JAR- und WAR-Dateien so umschreiben, dass aus javax ein jakarta wird. Damit lassen sich auch Bibliotheken nutzen, die noch keine eigene Jakarta-Variante haben.
Ich sehe das als Brücke, nicht als Dauerlösung. Ein umgeschriebenes Artefakt ist ein Artefakt, das niemand mehr so gebaut hat, wie der Autor es veröffentlicht hat, und im Fehlerfall wird die Suche nach der Ursache unübersichtlicher. Für einen Übergang, für Tests oder für Fälle, in denen eine Bibliothek nicht mehr gepflegt wird, kann es aber genau das Richtige sein.
Abwarten oder früh migrieren?
Die Frage, die sich jetzt viele stellen, lautet: Muss ich überhaupt etwas tun? Meine Antwort ist: Nicht sofort, aber vorbereiten schadet nicht.
Wer auf Tomcat 9, Jetty 10 oder einem Java-EE-8-Server läuft, ist nicht in Gefahr. Diese Linien werden weiter gepflegt, und die alten Namen verschwinden nicht über Nacht. Wer aber neue Anwendungen auf Jakarta EE aufsetzt oder in den nächsten Jahren ohnehin ein größeres Update plant, tut gut daran, den Umzug einzuplanen. Je länger man wartet, desto mehr Code und mehr Abhängigkeiten hängen am alten Namensraum.
Ein Vorgehen, das ich für vernünftig halte:
- Inventar anlegen. Welche Abhängigkeiten, direkt und transitiv, hängen an
javax.*? Ein Blick in den Abhängigkeitsbaum des Build-Werkzeugs und eine Suche im eigenen Code reichen für den Anfang. - Klären, wer schon so weit ist. Für jede wichtige Bibliothek: Gibt es eine Version für Jakarta EE 9? Wird sie noch gepflegt? Wo es keine gibt, braucht man einen Plan, sei es Ersatz oder Transformer.
- Automatisiert umschreiben. Das eigene Suchen und Ersetzen sollte skriptgesteuert und wiederholbar sein, nicht von Hand in der IDE:
grep -rl 'javax\.servlet' src | xargs sed -i 's/javax\.servlet/jakarta.servlet/g'Das gilt für jedes Paket einzeln, nicht pauschal für javax, aus dem oben genannten Grund. Außerdem muss man auf Stellen achten, die nicht im Java-Code stehen: Konfigurationsdateien, XML-Deskriptoren, Texte, in denen Klassennamen als Zeichenketten vorkommen. Ob Konfigurationsschlüssel mit umziehen, steht in der jeweiligen Spezifikation, ich würde das nicht raten, sondern nachlesen.
- Tests als Sicherheitsnetz. Ohne eine brauchbare Testabdeckung ist eine solche Umstellung ein Blindflug. Wer sie nicht hat, sollte vorher wenigstens für die wichtigsten Abläufe einfache Integrationstests schreiben.
- In einem Zweig umstellen und früh bauen. Besser ein Branch, der wochenlang parallel mitläuft und regelmäßig aktualisiert wird, als ein großer Umbau am Ende.
Wie ich es einordne
Ich bin ehrlich gespalten. Einerseits ist es ärgerlich, dass die Branche Zeit und Geld in eine Umbenennung stecken muss, die aus Rechtsgründen nötig wurde und technisch keinen Mehrwert bringt. Andererseits war das Warten auf Klarheit auf Dauer schlimmer. Seit 2018 hat man in der Schwebe gehangen, ob und wie es mit den Namen weitergeht. Jetzt ist der Weg klar, und die eigentliche Weiterentwicklung kann beginnen.
Was mich ein wenig beschäftigt: Dieser Umzug ist ein gutes Beispiel dafür, wie teuer Namen sein können. Ein Paketname ist einer der am tiefsten verdrahteten Teile eines Systems. Er steht in Quelltext, Konfiguration, Bytecode, Dokumentation und Köpfen. Wer eine Bibliothek veröffentlicht, sollte sich beim Benennen mehr Mühe geben, als man es sonst tut.
Für meine eigenen Projekte werde ich als Nächstes ein Inventar der Abhängigkeiten anlegen und dann einen kleinen Teil probeweise umstellen. Wenn ihr schon einen Umzug hinter euch habt, würde mich vor allem interessieren, welche Bibliothek euch am meisten aufgehalten hat.
Beitragsbild: Jakarta-EE-Logo von Eclipse Foundation, gemeinfrei (via Wikimedia Commons; unverändert auf eigenem Hintergrund). Jakarta EE ist eine Marke der Eclipse Foundation.
Christian Ackermann
Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.