Add jakarta support through bytecode transformation

[luckpoint]

Changes

This PR introduces comprehensive Jakarta EE support for the auth0-java-mvc-common library through Eclipse Transformer-based bytecode transformation. This enables the library to work seamlessly with both traditional Java EE (javax.servlet) and modern Jakarta EE (jakarta.servlet) environments without requiring separate codebases.

Key Changes:

• Build System Enhancements:

  • Added Jakarta test source set configuration (src/testJakarta/)
  • Implemented Eclipse Transformer integration for automatic javax→jakarta package transformation
  • Created performJakartaTransformation and transformJarToJakarta Gradle tasks
  • Added Jakarta-specific dependency configurations with jakarta.servlet-api:5.0.0

• Test Coverage:

  • Added JakartaCompatibilityTest.java to verify Jakarta EE servlet API compatibility
  • Implemented comprehensive tests for HttpServletRequest, HttpServletResponse, HttpSession, and Cookie Jakarta classes
  • Added testJakarta task to run Jakarta-specific tests with transformed bytecode

• Distribution:

  • Generates dual JAR artifacts: standard and Jakarta-compatible (with jakarta classifier)
  • Maintains backward compatibility with existing javax.servlet-based applications
  • Supports Tomcat 10+ and other Jakarta EE 9+ application servers

• Documentation:

  • Updated README.md with Jakarta EE installation instructions for both Maven and Gradle
  • Added clear distinction between javax.servlet and jakarta.servlet usage patterns
  • Specified minimum version requirements (jakarta.servlet 5.0+)

Classes and Methods Added:

• JakartaCompatibilityTest class with Jakarta servlet API verification tests
• Gradle tasks: performJakartaTransformation, transformJarToJakarta, testJakarta
• Jakarta source set configuration in build.gradle

Endpoints/APIs:

• No public API changes - maintains full compatibility with existing codebase
• Jakarta version accessible via Maven/Gradle classifier: mvc-auth-commons:1.12.0:jakarta

References

• Eclipse Transformer Project - Bytecode transformation tool for javax→jakarta migration

Testing

This change has been thoroughly tested to ensure compatibility across both servlet environments:

• This change adds test coverage

  • Added JakartaCompatibilityTest with comprehensive Jakarta servlet API tests
  • Tests verify HttpServletRequest, HttpServletResponse, HttpSession, and Cookie functionality
  • Integration tests confirm transformed bytecode works with Jakarta dependencies

• This change has been tested on the latest version of Java or why not

./gradlew testInJava-8 testInJava-11 testInJava-17 testInJava-21 --parallel

> Configure project :
Using version 1.12.0 for mvc-auth-commons group com.auth0
Test will be running in 8
Test will be running in 11
Test will be running in 17
Test will be running in 21

Deprecated Gradle features were used in this build, making it incompatible with Gradle 7.0.
Use '--warning-mode all' to show the individual deprecation warnings.
See https://docs.gradle.org/6.9.2/userguide/command_line_interface.html#sec:command_line_warnings

BUILD SUCCESSFUL in 2s
7 actionable tasks: 7 up-to-date

Manual Testing:

• Deploy to Tomcat 10+ with Jakarta classifier dependency
• https://github.com/luckpoint/auth0-servlet-sample/tree/feat/jakarta-package

Checklist

• I have read the Auth0 general contribution guidelines
• I have read the Auth0 Code of Conduct
• All existing and new tests complete without errors

[tanya732]

Hi @luckpoint

Thank you for this, it's a thoughtful and thorough contribution. The Eclipse Transformer approach and accompanying tests made it easy to understand, and we appreciate the effort you put into it.

We’ve decided to go in a different direction for Jakarta support and released 2.0.0-beta.0, which fully migrates to jakarta.servlet namespace and Java 17+

Because of that, we won’t be moving forward with this approach, so I’ll close the PR. If you get a chance to try the beta, we'd love your feedback: https://github.com/auth0/auth0-java-mvc-common/releases/tag/2.0.0-beta.0