~/blog/2018/10/java-11-lts-upgrade.md

Java 11 LTS: Worauf man beim Upgrade achten sollte

5 min
Beitragsbild: Java 11 LTS: Worauf man beim Upgrade achten sollte

Keine Zeit? Hier die Kurzversion in 30 Sekunden.

  • Java 11 ist am 25. September 2018 erschienen und das erste LTS-Release im neuen Sechs-Monats-Rhythmus.
  • Entfernt wurden die Java-EE- und CORBA-Module (JAXB, JAX-WS, javax.activation und andere) sowie Applet-Plug-in und Web Start, JavaFX gehört nicht mehr zum JDK.
  • Neu sind unter anderem der HTTP Client, TLS 1.3, var in Lambda-Parametern, java Datei.java und Flight Recorder im OpenJDK.
  • Typische Stolpersteine: fehlende Module, Warnungen zu illegal reflective access und zu alte Bibliotheken oder Build-Plugins.
  • Lizenz klären: Oracle JDK 11 ist für Produktion kostenpflichtig, die Oracle-OpenJDK-Builds stehen unter GPL; dazu gibt es AdoptOpenJDK und Zulu.

Vor zwei Wochen habe ich ein mittelgroßes Projekt testweise auf Java 11 gestellt. Nicht, weil es drängt, sondern weil ich wissen wollte, wie viel Arbeit dahintersteckt, bevor es drängt. Das Ergebnis: weniger Drama als befürchtet, aber ein paar Stellen, an denen man sich ohne Vorwarnung die Finger verbrennt. Dieser Beitrag ist eine Sammlung dessen, was ich dabei gelernt habe.

Warum Java 11 anders ist als 9 und 10

Java 9 hat das Modulsystem gebracht, Java 10 im März unter anderem var für lokale Variablen. Beide Releases wurden nur kurz gepflegt, und viele sind deshalb bei Java 8 geblieben. Java 11 ist der erste Release, der im neuen Rhythmus als LTS gekennzeichnet ist, also mit langer Unterstützung durch die Anbieter. Damit wird es zu dem Punkt, an dem Projekte von Java 8 aus ernsthaft umsteigen werden. Wer die beiden Zwischenstände übersprungen hat, bekommt die Änderungen von 9, 10 und 11 auf einmal.

Das ist der eigentliche Punkt: Nicht Java 11 allein macht Arbeit, sondern der Sprung über das Modulsystem hinweg.

Was entfernt wurde

Am meisten stolpert man über JEP 320. Die Module für Java EE und CORBA sind aus dem JDK verschwunden. Seit Java 9 waren sie schon als deprecated markiert und standen nicht mehr standardmäßig im Klassenpfad, mit Java 11 sind sie weg. Betroffen sind unter anderem:

  • JAXB (javax.xml.bind)
  • JAX-WS (javax.xml.ws)
  • javax.activation
  • javax.annotation aus dem Modul für die Web-Service-Annotationen
  • das Transaktionsmodul (JTA)
  • CORBA

Der Fehler zeigt sich beim Kompilieren oder zur Laufzeit als ClassNotFoundException oder fehlendes Paket. Die Lösung ist unspektakulär: Die Bibliotheken als Maven-Abhängigkeit einbinden. Für JAXB sieht das ungefähr so aus:

<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
    <version>2.3.0</version>
</dependency>

Dazu braucht man je nach Fall noch eine Implementierung, etwa die Referenzimplementierung von JAXB. Die genauen Koordinaten sollte man beim jeweiligen Projekt nachsehen, ich will hier keine falsche Sicherheit vorgaukeln. Wichtig ist die Haltung: Das war nie Teil der Java-SE-Idee, nur gewohnheitsmäßig lag es dabei.

Außerdem entfernt: das Applet-Plug-in und Java Web Start. Wer interne Anwendungen damit verteilt, braucht einen anderen Weg. JavaFX gehört nicht mehr zum Oracle JDK, es lebt als OpenJFX separat weiter und muss als eigene Abhängigkeit eingebunden werden. Nashorn, die JavaScript-Engine, und Pack200 sind als deprecated markiert. Das ist noch kein Entfernen, aber ein Hinweis, die Abhängigkeit zu hinterfragen.

Was neu ist

Ein paar Dinge sind richtig nützlich:

  • Der HTTP Client in java.net.http (JEP 321) ersetzt auf Dauer den unhandlichen HttpURLConnection. Er kann synchron und asynchron, und HTTP/2 ist dabei.
  • TLS 1.3 wird unterstützt.
  • var darf jetzt auch in Lambda-Parametern stehen, vor allem für Annotationen praktisch.
  • Einzelne Quelldateien lassen sich direkt starten, ohne vorher zu kompilieren:
java Hallo.java
  • Bei den Strings gibt es isBlank(), lines(), strip() und repeat(int).
  • Flight Recorder ist im OpenJDK enthalten, bisher war das eine kommerzielle Funktion von Oracle.
  • Experimentell sind der Garbage Collector ZGC und der „Epsilon“-Collector, der nichts aufräumt und für Tests von Speicherverhalten gedacht ist. Für Produktion sehe ich das noch nicht.

Nichts davon ist ein Grund zur Eile. Der Wechsel lohnt sich eher wegen der Pflege als wegen einzelner Funktionen.

Die Fallstricke beim Umstieg

Illegal reflective access. Beim Start tauchen Warnungen auf, dass eine Bibliothek per Reflection auf interne JDK-Klassen zugreift. Zurzeit ist das erlaubt, es wird gewarnt. Die Meldungen sollte man ernst nehmen, weil dieser Zugriff in späteren Versionen eingeschränkt werden soll. Kurzfristig hilft --add-opens, etwa --add-opens java.base/java.lang=ALL-UNNAMED. Das ist ein Pflaster, kein Heilmittel. Besser ist es, die verursachende Bibliothek zu aktualisieren.

Ältere Bibliotheken und Werkzeuge. Hier lag bei mir der meiste Aufwand. Alles, was Bytecode liest oder erzeugt, muss die neuen Klassendateiformate verstehen: ASM, Mockito (und was es darunter verwendet), Lombok, ältere Code-Coverage-Werkzeuge. Solche Fehler äußern sich oft kryptisch, etwa als Exception beim Parsen einer Klasse. Auch das Maven-Compiler-Plugin sollte in einer neueren Version laufen, damit die Option release funktioniert, die beim Kompilieren gegen eine bestimmte Zielversion hilft. Ich habe zuerst alle Plugins und Testbibliotheken aktualisiert, noch auf Java 8, und erst danach das JDK gewechselt. Das macht die Fehlersuche übersichtlicher.

jdeps und jdeprscan. Zwei Werkzeuge aus dem JDK sind hilfreich. jdeps zeigt, welche Pakete des JDK eine Anwendung benutzt, und findet interne APIs. jdeprscan sucht nach Aufrufen von als deprecated markierten Methoden. Ich lasse beide vor dem Umstieg über das gebaute Artefakt laufen und bekomme so eine Arbeitsliste.

Das Verhalten im Betrieb. Speicher- und Startparameter können sich auswirken, einzelne alte JVM-Optionen wurden entfernt. Auch in Containern lohnt ein Test, weil sich das Verhalten bei Speichergrenzen über die letzten Versionen geändert hat. Ich habe hier keine Messungen, nur den Rat: nicht annehmen, sondern ausprobieren.

Die Lizenzfrage

Das Thema wurde schon vor Wochen heiß diskutiert, und mit dem Release wird es konkret. Das Oracle JDK 11 ist für den Produktionseinsatz kostenpflichtig, es braucht einen Vertrag. Daneben bietet Oracle OpenJDK-Builds unter GPL an, die ohne Vertrag nutzbar sind, aber nur sechs Monate Updates bekommen. Wer dauerhaft ein Update-Versprechen braucht, schaut sich AdoptOpenJDK oder Azul Zulu an, oder nimmt das Paket der eigenen Linux-Distribution. Ich bin kein Jurist, die Details gehören in den jeweiligen Vertrag. Praktisch heißt es: Beim Umstieg auch festlegen, woher das JDK kommt, und das im Build und in den Docker-Images festschreiben.

Mein Vorgehen

  1. Plugins, Frameworks und Testbibliotheken auf aktuelle Versionen heben, solange noch Java 8 läuft.
  2. jdeps und jdeprscan über das Projekt laufen lassen.
  3. Auf Java 11 umschalten, Build und Tests laufen lassen, fehlende Module als Abhängigkeiten ergänzen.
  4. Warnungen zu illegal reflective access einsammeln und die Verursacher aktualisieren, --add-opens nur als Übergang.
  5. Eine Testumgebung mit realistischen Daten fahren, bevor irgendetwas in Produktion geht.

Für mein Testprojekt war ich so nach einem Abend durch, mit einer Handvoll Abhängigkeiten, die ich erneuern musste. Bei einem großen Altbestand kann das anders aussehen, und ich würde nicht auf den letzten Moment warten, sondern früh anfangen und schrittweise vorgehen. Der Aufwand verteilt sich besser, wenn man ihn nicht an einem Stichtag bündelt.

Beitragsbild: Duke, Java-Maskottchen (3D) von Joe Palrang, BSD (via Wikimedia Commons; unverändert auf eigenem Hintergrund). Java und Duke sind Marken der Oracle Corporation.

$ whoami
Christian Ackermann

Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.