Apache Tomcat migration tool for Jakarta EE

Clone this repo:

Branches

Tags

  1. 102f42a Change the curve of the EC key to run the tests on OpenJDK 15 or later by Emmanuel Bourg · 5 weeks ago master
  2. f23a649 Test the migration of signed jar files by Emmanuel Bourg · 6 weeks ago
  3. 1738963 Remove the EC signature files by Emmanuel Bourg · 6 weeks ago
  4. 9cc4b6f Remove unused methods in StringManager by Emmanuel Bourg · 6 weeks ago
  5. 3e3267b Test the migration of a jar file by Emmanuel Bourg · 6 weeks ago

Apache Tomcat migration tool for Jakarta EE

Build Status Coverage Status License

Overview

This tool is a work in progress.

The aim of the tool is to take a web application written for Java EE 8 that runs on Apache Tomcat 9 and convert it automatically so it runs on Apache Tomcat 10 which implements Jakarta EE 9.

The tool can be used from the command line or as an Ant task.

Usage

Build

Build the migration tool with:

./mvnw verify

Migrate

Migrate your Servlet application with:

java -jar target/jakartaee-migration-*-shaded.jar <source> <destination>

The source should be a path to a compressed archive, a folder or an individual file. The destination will be created at the specified path as a resource of the same type as the source.

INFO This tool will remove cryptographic signatures from JAR files contained in the source, as the changed resources would not match them anymore.

A warning will be logged for each JAR file where the signature has been removed.

Ant task

The migration tool is available as an Ant task, here is an example:

<taskdef name="javax2jakarta" classname="org.apache.tomcat.jakartaee.MigrationTask" classpath="jakartaee-migration-*-shaded.jar"/>

<javax2jakarta src="webapp.war" dest="webapp.migrated.war" profile="tomcat"/>

Differences between Java EE 8 and Jakarta EE 9

Jakarta EE 9 is still under development and there are some details that remain to be worked out.

The differences currently supported by this tool are:

  • Renaming packages for Jakarta EE 9 APIs from javax.* to jakarta.*

Note: It will not be necessary to migrate any references to XML schemas. The schemas don't directly reference javax packages and Jakarta EE 9 will continue to support the use of schemas from Java EE 8 and earlier.