Java 23: Markdown im Javadoc und der Rückzug der String Templates

Keine Zeit? Hier die Kurzversion in 30 Sekunden.
- Java 23 erschien am 17. September 2024 und ist kein LTS-Release; das nächste LTS ist Java 25 im September 2025.
- JEP 467 bringt Markdown in Dokumentationskommentaren mit
///statt HTML und Tags.- Die String Templates (Preview in 21 und 22) wurden zurückgezogen und sind in 23 nicht mehr enthalten, ein Neuentwurf ist offen.
- Viele Previews gehen weiter: primitive Typen in Patterns, Module Import Declarations, implizite Klassen mit Instanz-main, Flexible Constructor Bodies, Stream Gatherers.
- Der ZGC läuft standardmäßig im generationalen Modus;
sun.misc.Unsafe-Speicherzugriffe sind für die Entfernung vorgesehen.
Ein Feature zu streichen, das schon zwei Releases lang als Preview vorlag, ist unbequem. Für alle, die es ausprobiert haben, für die Entwickler der Sprache und für die Autoren, die Beiträge darüber geschrieben haben. Genau das ist mit den String Templates passiert, und es ist für mich das interessanteste Detail an Java 23, das am 17. September erschienen ist. Die Neuerungen im Einzelnen sind eher ein Sammelsurium, und ein LTS-Release ist es auch nicht. Aber an diesem Rückzug lässt sich einiges über die Art ablesen, wie Java sich heute weiterentwickelt.
Markdown statt HTML im Javadoc
Beginnen wir mit dem Teil, den man sofort benutzen kann. Dokumentationskommentare lassen sich jetzt in Markdown schreiben (JEP 467). Statt des gewohnten /** ... */ mit HTML-Elementen verwendet man Zeilen, die mit /// beginnen:
/// Berechnet den Bruttopreis.
///
/// Der Satz wird als Dezimalzahl erwartet, `0.19` steht
/// also für neunzehn Prozent.
///
/// - Der Nettopreis darf nicht negativ sein.
/// - Siehe auch [Preise#rabatt(double)].
///
/// @param netto Nettopreis
/// @param satz Steuersatz
/// @return Bruttopreis
public static double brutto(double netto, double satz) {
return netto * (1 + satz);
}Wer lange Javadoc geschrieben hat, kennt den Reflex: ein <p> hier, ein <ul> dort, ein {@code ...} für jede Kleinigkeit, und am Ende ein Kommentar, der im Quelltext schlechter lesbar ist als das Ergebnis. Mit Markdown wird der Quelltext lesbarer, Listen sind Listen, Code steht in Backticks, Verweise gehen über eckige Klammern. Die Tags wie @param und @return bleiben, und die klassischen Kommentare funktionieren weiter. Es ist ein kleiner Schritt, aber einer, der im Alltag Spaß macht. Ob die Werkzeuge in meiner Umgebung, etwa IDEs, die Darstellung überall schon richtig beherrschen, habe ich nicht systematisch geprüft. Hier würde ich mit einer kleinen Probe anfangen.
Der Rückzug der String Templates
Nun zum Schmerzpunkt. String Templates waren in Java 21 als Preview angekommen und in 22 noch einmal als zweite Preview erschienen. Die Idee war, Zeichenketten mit eingebetteten Ausdrücken zu bauen, aber mit einem Mechanismus dazwischen, der verhindert, dass aus Eingaben unbedacht SQL oder anderer problematischer Text zusammengeklebt wird. In Java 23 ist das Feature nicht mehr enthalten. Es wurde zurückgezogen, ein Neuentwurf ist offen, und wie er aussehen wird, ist nicht entschieden.
Die Begründung, so wie ich sie verstanden habe: Beim Beobachten der Rückmeldungen wurde klar, dass der Entwurf an einigen Stellen nicht überzeugte. Das Zusammenspiel von Syntax und Verarbeitern wurde als zu schwer empfunden, es gab Streit über das Design. Statt es eilig festzuschreiben, hat man das Feature entfernt. Das halte ich für eine mutige Entscheidung, und für eine, die der Sprache eher guttut, als sie ihr schadet.
Was ein Preview-Prozess wert ist
Hier liegt für mich der eigentliche Punkt. Der Preview-Prozess ist dafür gedacht, Dinge auszuprobieren, bevor sie endgültig werden. Das funktioniert aber nur, wenn am Ende auch ein „Nein“ oder ein „Noch nicht“ möglich ist. Ein Preview, das immer in der endgültigen Fassung landet, ist ein Ankündigungsinstrument und kein Prüfinstrument. Der Rückzug der String Templates zeigt, dass es ernst gemeint ist.
Das hat Folgen für die eigene Praxis. Wer ein Preview-Feature im Code verwendet, muss damit rechnen, dass es sich ändert oder verschwindet. Das ist keine Warnung vor dem Ausprobieren, sondern vor dem Verlassen darauf. Ich würde Previews in Experimenten, Werkzeugen und privaten Projekten nutzen, aber nicht in Code, der in einem Jahr noch laufen soll, ohne dass jemand daran denkt. Das Kompilieren mit --enable-preview ist deshalb auch absichtlich lästig.
Der Rest der Previews
Ansonsten ist Java 23 in großen Teilen ein Release der fortgesetzten Previews, einige davon sind schon alte Bekannte:
- Primitive Typen in Patterns (JEP 455): erste Preview. Patterns,
instanceofundswitchsollen auch mit primitiven Typen zusammenarbeiten. - Module Import Declarations (JEP 476): erste Preview. Mit
import module java.base;importiert man auf einen Schlag alle exportierten Pakete eines Moduls, was besonders für kleine Programme und Skripte praktisch ist. - Implizit deklarierte Klassen und Instanz-main (JEP 477): dritte Preview. Der kleinste Einstieg wird zu einer Methode ohne Klassendeklaration.
- Flexible Constructor Bodies (JEP 482): zweite Preview. Anweisungen dürfen vor dem Aufruf von
super(...)oderthis(...)stehen, solange sie die entstehende Instanz nicht benutzen. - Stream Gatherers (JEP 473): zweite Preview. Eigene Zwischenoperationen für Streams.
- Structured Concurrency und Scoped Values bleiben ebenfalls in der Preview.
Ein Beispiel für den Einsteigerfall, der mir am besten gefällt:
void main() {
System.out.println("Hallo, Welt");
}Dass das ein vollständiges Programm sein kann, hätte ich mir vor ein paar Jahren nicht vorstellen können. Für Lernende ist es ein enormer Gewinn, weil man nicht erst public static void main(String[] args) erklären muss. Für Gatherers gilt Ähnliches, ein Beispiel für Fenster aus drei Elementen:
Stream.of(1, 2, 3, 4, 5, 6, 7)
.gather(Gatherers.windowFixed(3))
.toList();
// [[1, 2, 3], [4, 5, 6], [7]]Beide Beispiele brauchen --enable-preview und die passende Quellversion. Ohne diese Flags kompiliert nichts.
Unter der Haube
Zwei Punkte sind weniger sichtbar, aber nicht unwichtig. JEP 474 stellt den ZGC standardmäßig auf den generationalen Modus um. Wer den ZGC benutzt, bekommt damit ohne weiteres Zutun das neuere Verhalten, und man sollte beim Aktualisieren einmal in die eigenen Messwerte schauen, statt anzunehmen, dass es automatisch besser wird. Mit JEP 471 werden die Speicherzugriffsmethoden in sun.misc.Unsafe als „deprecated for removal“ markiert. Das betrifft vor allem Bibliotheken, die diese Schnittstelle seit jeher für Tricks benutzen. Als Anwendungsentwickler merkt man es über Warnungen und über die Frage, welche eingesetzten Bibliotheken noch auf dem alten Weg unterwegs sind. Die Alternativen, etwa die Schnittstelle für Fremdspeicher, gibt es bereits.
Wie ich damit umgehe
Java 23 ist kein LTS-Release und hat nur den kurzen Support-Zeitraum, der jedem Zwischenrelease zusteht. Für Produktion bleibt Java 21 meine Basis, und das nächste Langzeit-Release wird Java 25 im September 2025. Aber 23 ist für mich ein gutes Release zum Ansehen: Ich installiere es parallel, probiere die Previews in einem Wegwerfprojekt aus und lese die JEPs, bevor sie in einem LTS-Release landen.
Die String Templates werden mir fehlen, auch wenn ich sie nie produktiv benutzt habe. Aber ich bin froh, dass man die Entscheidung getroffen hat, nicht aus Gewohnheit weiterzumachen. Bei einer Sprache, die noch viele Jahre halten soll, ist ein sauberer Rückzug besser als ein halber Erfolg.
Habt ihr Previews schon in echten Projekten ausprobiert, und wo habt ihr die Grenze gezogen? Mich würde vor allem interessieren, ob jemand die Markdown-Kommentare schon im Team eingeführt hat.
Beitragsbild: Markdown-Logo von Dustin Curtis, CC0 1.0 (via Wikimedia Commons; unverändert auf eigenem Hintergrund). Kein Markenhinweis auf Commons.
Christian Ackermann
Softwareentwickler (C++, C, Java, C#) aus der Oberpfalz, bloggt seit 2001 über Linux, Technik und Kochen.