Servlet 2.3 heute zum Laufen bringen: die Umgebung der Java Zeitreise

Ausgangslage

Die «Java Zeitreise» baut Java-Epochen seit 2001 im Stil der Zeit nach: kleine, getestete Beispiele, offen als Nachbau gekennzeichnet. Epoche 1 ist die Zeit von Servlet 2.3 und JSP 1.2, mit einer web.xml ohne Annotationen, einem WAR-Archiv, einem Build mit Ant und Tomcat 4.1 als Server.

Bevor ich die erste Übung schreibe, brauche ich eine Umgebung, in der das läuft. Tomcat 4.1 setzt Servlet 2.3 und JSP 1.2 um. Einen so alten Server auf einem heutigen MacBook Air mit Apple-Chip zu betreiben, erschien mir aber unrealistisch. Ausprobiert habe ich es nicht.

Entscheidung

Der Quelltext soll im Stil der Epoche entstehen, der Server darf modern sein. Ich habe drei Wege abgewogen:

  • Tomcat 4.1 selbst: historisch korrekt, aber nicht ausprobiert und vermutlich aufwendig.
  • Tomcat 10 oder neuer: Dort heissen die Pakete jakarta.* statt javax.*, der alte Code müsste umgestellt werden. Es soll eine automatische Umstellung beim Deployment geben, getestet habe ich sie nicht.
  • Tomcat 9: die letzte Tomcat-Version mit den javax-Paketen. Sie setzt Servlet 4.0 um und läuft ab Java 8.

Ich habe mich für Tomcat 9 in Docker entschieden. So ist die Umgebung reproduzierbar, und dieselben Images kann später die Pipeline verwenden. In der ersten Stufe baut Ant mit JDK 17, der Code wird gegen die Servlet-API 2.3 kompiliert, auf Java-8-Niveau. In der zweiten Stufe läuft das WAR auf Tomcat 9.

Ein Nachteil: Der Support für den Zweig 9.0.x endet laut Ankündigung des Projekts am 31. März 2027. Danach ist ein Zweig 9.1.x mit Releases bis zum 31. Dezember 2030 angekündigt. Die Umgebung läuft nur lokal auf meinem Rechner, nicht öffentlich im Internet.

Die Angaben zu den Versionen stammen von der Tomcat-Webseite und aus der Servlet-Spezifikation. Gebaut, gestartet und getestet habe ich selbst.

Umsetzung

Alle Dateien dieses Beitrags liegen im öffentlichen Repo java-time-travel, im Ordner epoche-01-servlet-jsp/umgebung.

1. Docker starten. Das Kommandozeilenprogramm war installiert, aber docker run meldete, der Dienst sei nicht erreichbar. Ich hatte schlicht vergessen, Docker Desktop zu öffnen. Erst als unten links «Engine running» stand, ging es weiter.

Docker Desktop mit der Statusanzeige «Engine running»

2. Servlet-API 2.3 holen. Die Jar liegt auf Maven Central. Mit file prüfe ich, dass wirklich ein Archiv angekommen ist:

mkdir -p lib
curl -L -o lib/servlet-api-2.3.jar https://repo1.maven.org/maven2/javax/servlet/servlet-api/2.3/servlet-api-2.3.jar
file lib/servlet-api-2.3.jar

3. Zwei Stufen im Dockerfile. Die erste baut das WAR mit Ant, die zweite führt es auf Tomcat 9 aus (gekürzt):

FROM eclipse-temurin:17-jdk AS build
RUN apt-get update && apt-get install -y --no-install-recommends ant
WORKDIR /app
COPY build.xml .
COPY src src
COPY web web
COPY lib lib
RUN ant war

FROM tomcat:9.0-jdk17-temurin
RUN rm -rf /usr/local/tomcat/webapps/*
COPY --from=build /app/build/hallo.war /usr/local/tomcat/webapps/hallo.war

4. Bauen, starten, aufrufen.

docker build -t zeitreise-test .
docker run --rm -p 8080:8080 --name zeitreise-test zeitreise-test
curl -i http://localhost:8080/hallo/hallo

Damit auch die Ausgabe von Ant sichtbar wird, baue ich mit --progress=plain und filtere sie auf drei Zeilen:

docker build --no-cache --progress=plain -t zeitreise-test . 2>&1 | grep -E "BUILD SUCCESSFUL|Total time|naming to"

Ant meldet «BUILD SUCCESSFUL», danach bekommt das Image seinen Namen (auf drei Zeilen gefiltert)

Im Log von Tomcat steht (gekürzt):

Server version name:   Apache Tomcat/9.0.123
[…]
Deploying web application archive [/usr/local/tomcat/webapps/hallo.war]

Und die Antwort des Servlets:

Hallo aus einem Servlet im 2.3-Stil
Container: Apache Tomcat/9.0.123
Servlet-API des Containers: 4.0

Browser mit der Ausgabe des Servlets (Aufruf von localhost:8080/hallo/hallo)

Erkenntnis

Es funktioniert: Ein Servlet, das nur Klassen der Servlet-API 2.3 benutzt, mit einer web.xml mit 2.3-Kennung, läuft auf Tomcat 9. Der Container meldet aber Servlet-API 4.0. Der Server ist also neuer als der Code, und genau deshalb ist das ein Nachbau und kein Original.

Nicht belegt ist, wie sich Tomcat 4.1 selbst verhält, zum Beispiel bei der Prüfung der web.xml. Ebenso ist offen, ob die DTD ohne Internetzugang gelesen wird. Mein Container hatte Zugang.

Eine Kleinigkeit hat mich überrascht: Docker blendet bei einem erfolgreichen Build die Ausgabe von Ant aus. Dass ant war durchgelaufen ist, sah ich zuerst nur daran, dass der Build nicht abbricht. Mit --progress=plain bleibt die Ausgabe sichtbar, und Ant meldet «BUILD SUCCESSFUL».

Quellen