Support for Tomcat 11.x (Servlet API 6.1 and Jakarta EE 11)

[dstenger]

deegree webservices shall run on Tomcat 11.

[dstenger]

I executed manual tests with deegree 3.6 on Java 21 and Tomcat 11 and no problems occurred. Thus, the current build of deegree 3.6 is runable with Tomcat 11.

[dstenger]

There is a container image available with Tomcat 11 and JDK 21 with deegree 3.6:
docker pull tfr42/deegree:3.6-jdk21-tomcat11

https://hub.docker.com/layers/tfr42/deegree/3.6-jdk21-tomcat11/images/sha256-99f562b6e30ff0babcc13dea83fca7ea76aa1f4b9b25b79afb35f7378d8b2ce4

This can be used for testing.

[tfr42]

@dstenger Important are the dependencies from JSF and Primefaces which core Jakarta APIs they support. An overview would help here, also for future updates.

[dstenger]

These specs are updated in comparison to Tomcat 10 (extracted from https://tomcat.apache.org/whichversion.html). Also, the updateable dependencies of deegree are listed:

• Servlet Spec 6.0 -> 6.1

      <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <version>6.0.0</version>
        <scope>provided</scope>
      </dependency>

• Pages Spec 3.1 -> 4.0

      <dependency>
        <groupId>jakarta.servlet.jsp</groupId>
        <artifactId>jakarta.servlet.jsp-api</artifactId>
        <version>3.1.1</version>
        <scope>provided</scope>
      </dependency>

• EL Spec 5.0 -> 6.0

      <dependency>
        <groupId>jakarta.el</groupId>
        <artifactId>jakarta.el-api</artifactId>
        <version>5.0.1</version>
        <scope>provided</scope>
      </dependency>

• WebSocket Spec 2.1 -> 2.2
• Authentication Spec (JASPIC) 3.0 -> 3.1
• Annotation Spec 2.1 -> 3.0

      <dependency>
        <groupId>jakarta.annotation</groupId>
        <artifactId>jakarta.annotation-api</artifactId>
        <version>2.1.1</version>
      </dependency>

Set this API dependency to provided as it is provided by Tomcat: #1896

Further dependencies and apis not provided by Tomcat:

      <dependency>
        <groupId>jakarta.servlet.jsp.jstl</groupId>
        <artifactId>jakarta.servlet.jsp.jstl-api</artifactId>
        <version>3.0.2</version>
        <scope>runtime</scope>
      </dependency>

No new release for Jakarta EE 11: https://jakarta.ee/specifications/tags/

      <dependency>
        <groupId>org.glassfish</groupId>
        <artifactId>jakarta.faces</artifactId>
        <version>4.0.12</version>
      </dependency>

Can be updated to version 4.1: https://jakarta.ee/specifications/faces/

      <dependency>
        <groupId>jakarta.enterprise</groupId>
        <artifactId>jakarta.enterprise.cdi-api</artifactId>
        <version>4.0.1</version>
      </dependency>

Can be updated to version 4.1: https://jakarta.ee/specifications/cdi/

      <dependency>
        <groupId>com.sun.activation</groupId>
        <artifactId>jakarta.activation</artifactId>
        <version>1.2.2</version>
      </dependency>

Can be updated to version 2.1 immediately (related to axiom): https://jakarta.ee/specifications/activation/
No new release for Jakarta EE 11.

      <dependency>
        <groupId>jakarta.xml.bind</groupId>
        <artifactId>jakarta.xml.bind-api</artifactId>
        <version>4.0.4</version>
      </dependency>

No new release for Jakarta EE 11: https://jakarta.ee/specifications/xml-binding/

      <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-fileupload2-jakarta-servlet6</artifactId>
        <version>2.0.0-M4</version>
      </dependency>

There does not seem to be an updated dependency.

      <dependency>
        <groupId>jakarta.mail</groupId>
        <artifactId>jakarta.mail-api</artifactId>
        <version>2.1.5</version>
        <scope>provided</scope>
      </dependency>

No new release for Jakarta EE 11: https://jakarta.ee/specifications/mail/

      <dependency>
        <groupId>jakarta.activation</groupId>
        <artifactId>jakarta.activation-api</artifactId>
        <version>2.1.4</version>
      </dependency>

No new release for Jakarta EE 11: https://jakarta.ee/specifications/activation/

      <dependency>
        <groupId>jakarta.xml.soap</groupId>
        <artifactId>jakarta.xml.soap-api</artifactId>
        <version>3.0.2</version>
      </dependency>

No new release for Jakarta EE 11: https://jakarta.ee/specifications/soap-attachments/

[dstenger]

JSF

      <dependency>
        <groupId>org.glassfish</groupId>
        <artifactId>jakarta.faces</artifactId>
        <version>4.0.12</version>
      </dependency>

Version 4.0.12 (latest of 4.0 line) is depending on Servlet API 6.0.0: https://central.sonatype.com/artifact/org.glassfish/jakarta.faces/4.0.12/dependencies

Version 4.1.4 (latest of 4.1 line) is depending on Servlet API 6.1.0: https://central.sonatype.com/artifact/org.glassfish/jakarta.faces/4.1.4/dependencies

Primefaces

    <dependency>
      <groupId>org.primefaces</groupId>
      <artifactId>primefaces</artifactId>
      <version>14.0.14-LTS</version>
      <classifier>jakarta</classifier>
    </dependency>

Version 14.0.14-LTS (latest of 14.0 line) is depending on jakarta.faces 2.3.21 (scope provided): https://central.sonatype.com/artifact/org.primefaces/primefaces/14.0.14-LTS/dependencies
Thus, currently primeface and jakarta faces are currently not aligned: 4.0.12 vs. 2.3.21

Version 15.0.8 (latest of 15.0 line) is also depending on jakarta.faces 2.3.21 (scope provided): https://central.sonatype.com/artifact/org.primefaces/primefaces/15.0.8/dependencies
Thus, currently primeface and jakarta faces are still not aligned: 4.0.12 vs. 2.3.21

    <dependency>
      <groupId>org.primefaces.extensions</groupId>
      <artifactId>primefaces-extensions</artifactId>
      <version>14.0.16</version>
      <classifier>jakarta</classifier>
    </dependency>

Here, the situation is exactly the same.

Support matrix of primefaces: https://github.com/primefaces/primefaces?tab=readme-ov-file#versions

• Version 14.0.14-LTS supports jsf versions 2.3 - 4.0.
• Version 15.0.8 supports jsf versions 2.3 - 4.1.

Summary

Both, primefaces 14 and 15 are compatible with the currently used jsf version 4.0.
If we update to jsf version 4.1, we must use primfaces 15.
jsf 4.0 should be supported by Tomcat 10 and 11 as Jakarta Servlet 6.0 is a minimum requirement: https://github.com/eclipse-ee4j/mojarra/blob/4.0/README.md
jsf 4.1 is supported by Tomcat 11 but not by Tomcat 10 as Jakarta Servlet 6.1 is a minimum requirement: https://github.com/eclipse-ee4j/mojarra/blob/4.1/README.md

Possible combinations:

Primefaces	JSF	Jakarta Servlet (Tomcat)
15	4.1	6.1 (11)
15	4.0	6.0/6.1 (10/11)
14	4.0	6.0/6.1 (10/11)