Re: conversion tool 9 to 10

On 12/01/2026 19:12, Rob Sargent wrote:
> Hello again, it's been a minute
> 
> I may need to upgrade my embedded tomcat application and have a couple 
> of questions.
> 
> Other than the obvious javax.<servlety-stuff> -> jakarta substitutions 
> what else does it change?

Exactly which Java EE -> Jakarta EE conversion it does depend on which 
profile you pick. Options are:

- just Servlet
- all the APIs Tomcat provides
- all the Java EE specs

There is also a Jakarta EE to Java EE profile if you need to down convert.

Other things converted:

- OSGi dependencies in MANIFEST.MF files.

> Can the tool "update in-place"?

You can use it in three ways.

1. Standalone. Pass it a WAR/JAR/directory and it will convert it.

2. On deployment. Place your WAR file in webapps-javaee and Tomcat will 
create a converted version in webapps and load it.

3. At runtime by setting the jakartaConverter attribute of the Loader to 
the required conversion profile name.

> I have run the tool on my "webapp" source dir, which has only a half a 
> dozen servlets.  Should I also run the tool in the app source dir which 
> also has some javax.servlet etc imports?  Indeed, run it over my entire 
> code base?

It needs to run over all your source code. For each dependency you 
either need to obtain a Jakarta EE compatible JAR or use the tool to 
convert a Java EE JAR. Note some dependencies will not use Java EE APIs 
and won't need updating / converting.

Mark