Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [jakartaee-platform-dev] Optional parts of a Spec or a "Bridge"



There’s a bunch of questions wrapped up in this.


First – Arjan’s point should Jakarta EE specifications be specifications that target the overall platform and therefore be internally consistent with the whole platform. I support this point. I think being overly abstract to support implementations outside of the overall Jakarta EE ecosystem is detrimental to Jakarta EE as a whole. This is an important future direction point. Are we writing specifications as standards for the whole Java industry or are we writing specifications that support creating multiple independent implementations within the Jakarta EE ecosystem? However I don’t want to hijack the thread for that debate.


Second – relating to the specific issue referenced by Werner – I support a lot of what Gavin is saying in the issue – the semantics of the API and how it works should be self contained in the specification document so that an independent implementation of the specification can be created without referring to other documents or implementations. This is especially important in Jakarta EE where we do not have a “reference implementation” you can look at and compare with.


Third – I support Werner’s point on Jakarta Data that it should support repositories that are not JPA. My understanding of the points made in the issue is that if that is the case then references to JPA should be removed from the top level specification document. Therefore given the current definition of optional a separate bridge specification seems logical to me, perhaps developed by the same specification project team and also included in both Web Profile and Platform. The reason I feel it needs to be a bridge spec is that it should be specified so that there can be multiple independent implementations of the bridge and these should work the same way to enable application portability between Jakarta EE implementations.







From: jakartaee-platform-dev <jakartaee-platform-dev-bounces@xxxxxxxxxxx> On Behalf Of Arjan Tijms via jakartaee-platform-dev
Sent: Friday, September 1, 2023 2:11 PM
To: jakartaee-platform developer discussions <jakartaee-platform-dev@xxxxxxxxxxx>
Cc: Arjan Tijms <arjan.tijms@xxxxxxxxxxx>
Subject: Re: [jakartaee-platform-dev] Optional parts of a Spec or a "Bridge"




I want to warn, again, about designing anything overly abstract. It always sounds so good and nice to be agnostic of everything, so that this proverbial guy deep in the jungle of japan can use our Java spec with Python and some Python based framework even.


But in practice this causes a lot of hurt, and makes things quite difficult to use.


Jakarta Security is, IMHO, infinitely easier to use since it just targets Servlet and CDI. Jakarta Authentication is according to many (it seems) horrible to use, precisely because it's agnostic to everything. It was designed to work with every possible representation of a request for instance, but in practice it has only ever been used with HttpServletRequest (okay, and SOAP, but it made little sense there).


We may want to compare this with the most popular framework out there; Spring. Does Spring ever try to be agnostic of itself, or does every Spring API depend on Spring Beans and whatever else it needs from Spring, without any shame?


Kind regards,

Arjan Tijms





On Fri, 1 Sept 2023 at 13:13, Werner Keil via jakartaee-platform-dev <jakartaee-platform-dev@xxxxxxxxxxx> wrote:


After Jakarta Data was just successfully accepted to the Full and Web Profile, it is equally important for users of the Core Profile who want to use repositories and other features with the database of their choice, either NoSQL or SQL/JDBC/JPA based.

However, there is desire by some in the Persistence camp, to force Jakarta Persistence as a mandatory dependency onto Jakarta Data, see


Which is where I also made this remark:

There are 3 options where these "implementations" or specializations could happen:

* In actual implementation modules, much like spring-data-jpa or micronaut-data-jpa do now
* In Jakarta Persistence as a downstream spec
* In a "Bridge" spec between Data and Persistence, a bit like the Portlet Faces Bridges defined by the JCP or the bridging efforts between Jakarta Security and Microprofile

A 4th option is currently not realistic, it would require optional sub-modules that depend on Jakarta Persistence/JPA etc. but Jakarta EE right now only knows "optional" for features to be phased out soon.

Although the Core Profile under 2.2. Optional Components already defined some specs that are optional for that profile, so the question is, would it be possible to do this on a detail spec level, or does such a spec need a "bridge" or another separate spec like "jakarta-data-persistence"?

Frameworks like Spring Data or Micronaut Data use JPA only in sub-modules that are more an implementation than spec/API, but of course they are no specs to begin with, so it is easier for them.

I believe, the adoption of Jakarta Data will suffer if JPA is forced down the throat of every Jakarta Data use case, whether it's NoSQL or other non-relational usage of the spec.

And let's not forget those who complained here earlier, that certifying for Data was too hard, what if they need to certify against Persistence as well, even if they don't use relational databases.

Take Apache Johnzon: which while still calling it "JavaEE 10" hopes to pass the TCKs of Jakarta JSON Processing and Binding. Another project could also decide to implement just JSON Processing, it is not forced to implement or support both.



jakartaee-platform-dev mailing list
To unsubscribe from this list, visit

Back to the top