Enterprise Java

Thoughts on the Jakarta EE package name change

The Eclipse Foundation announced that Jakarta EE cannot continue to use the javax package name. Apparently this comes with the fact that while Java EE bases on this name, no further modifications are allowed to classes or packages starting with that name.

While this is certainly bad news, for me, the bad news already started when it was announced that Jakarta EE can’t use the javax name for new specifications and sub-packages. That would have already mean continuing to evolve a platform that becomes more inconsistent over time.

Given the situation we’re in, I think it makes sense to make a clear cut and migrate to the proposed jakarta name.

This certainly means a huge impact for the whole Java ecosystem, everything that bases on any Enterprise API, not only the standards themselves. How to tackle that reasonably?

I believe the most important goal is to minimize the impact for the users, that is, developers out there. I see two major changes that have to be made, besides the code usage in projects.

Any runtimes that know and handle EE APIs, e.g. application servers, have to adapt and switch to the new name. They will have to implement some functionality to live with both javax and jakarta, very likely simultaneously, simply because they have to. There’s too much code out there that won’t be migrated to base on either javax or jakarta fashion. In the real world, there are legacy projects, tons of libraries and dependencies, binaries for which no source exists, and much more. We need a way to tell a runtime to just live with both, at least temporarily, or in specific compatibility profiles. There are already proposals how to do that, including Bytecode manipulation and other black magic :-) I’ve talked to IBM engineers that this is also the way Liberty will go. For me, making the life easier for developers has the highest importance.

The second big impact will be for frameworks, libraries, and tooling built around Enterprise Java that import something with javax contained in Java EE. At least once some new functionality is introduced, they will have to switch. If they want to ensure, that their project still works under Jakarta EE, even without a “compatibility runtime”, they’ll have to switch too. I think a clean cut is to offer the current Java EE APIs, under both Java EE, with javax, and Jakarta EE with jakarta. This would be needed for both the platform (javaee-api) and individual specifications such as JAX-RS. The projects then have an easy control, via their resolved dependencies, which one to use and can swap their imports accordingly. If Jakarta EE makes a clean cut, for example, switching only to the jakarta namespaces in the next release, say 9, or 8.1, but keeping everything else similar with Java EE 8, this makes it easier for projects to switch.


In my opinion, the Jakarta EE ecosystem should:

  • minimize the impact for the users, that is developers
  • make runtimes support both javax and jakarta, at least temporarily or in a compatibility profile
  • make a clean cut to switch the package names in Jakarta EE platforms and individual standards, without switching any other functionality

Found the post useful? Subscribe to my newsletter for more free content, tips and tricks on IT & Java:

Success! Now check your email to confirm your subscription.

Published on Java Code Geeks with permission by Sebastian Daschner, partner at our JCG program. See the original article here: Thoughts on the Jakarta EE package name change

Opinions expressed by Java Code Geeks contributors are their own.

Sebastian Daschner

Sebastian Daschner is a self-employed Java consultant and trainer. He is the author of the book 'Architecting Modern Java EE Applications'. Sebastian is a Java Champion, Oracle Developer Champion and JavaOne Rockstar.
Notify of

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Inline Feedbacks
View all comments
Back to top button