Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [] Specification text

First of all, these are all excellent questions.    I can address the more general ones but as for the XA specific questions I leave that for the working groups of JTA and JDBC to work out among themselves.  

I do not know for certain what aspects of the donated (donated by Oracle) APIs can be changed without violating copyright. I suspect we have some flexibility with regard to javadoc but I plan to bring this up in the Specification Comittee meeting so hopefully more guidance on that is forth coming.  As for following the existing specification, the answer is yes.  At this point assume that the existing specification defines the requirements for Jakarta EE 8. There will probaby be some changes but Jakarta EE 8 is intended to closely match Java EE 8 so as to ease the community into the new platform before any big changes are made in future versions.

On Thu, May 3, 2018 at 8:29 AM Tom Jenkinson <tom.jenkinson@xxxxxxxxxx> wrote:
Thanks for the response!

Regarding your comment that the idea might be to align the javadocs with the specification first, would that be an activity that the Jakarta community would do? If so, will it be OK to use the existing JTA specification text when adding these missing conditions to the Javadoc? On the other hand, perhaps the TCK already verifies some of these behaviours and so the Javadoc can draw from the conditions tested in the TCK instead?

Thinking specifically about the issue I mentioned regarding threading support for XAResources I wonder if the fact the XAResource interface is provided by the java.sql module (rather than JTA) might pose some difficulty as we won't be in control of adding requirements that are appropriate to add to the XAResource interface itself. In principle the requirement might be able to be associated with the enlistResource(XAResource) method of the XAResource interface itself but might that lead to confusion where an XAResource implementer just uses the XAResource interface to produce their implementation and are not aware of the requirements that we add to the javax.transaction.Transaction enlistResource javadoc?

I take on board that answers to these questions are not available yet and will be part of the remit of the specification committee so I provide them to help with the discussions.

On 2 May 2018 at 15:56, Richard Monson-Haefel <rmonson@xxxxxxxxxxxxx> wrote:
Hi Tom,

This is an excellent question. I’m an alternate of the Jakarta EE Specification Committee.  The committee will be meeting for the first time later this week to begin setting up norms and rules for defining specifications.  My gut tells me to align the Java doc with the specification, but let me bring this up to the committee when it meets so that I can provide you with an official response.  Once the Specification Committee has defined processes, guidelines, and rules for creating and updating specifications these kinds of issues will be addressed.

More questions of this type are very helpful to the specification committee so keep them coming!


On Wed, May 2, 2018 at 8:19 AM Tom Jenkinson <tom.jenkinson@xxxxxxxxxx> wrote:

I am the project lead for the EE4J JTA project. I am looking to start work on producing specification text for the project using the public Javadocs we have in our GitHub repo as the basis: 

I have a question of what we should do in cases where the Javadoc is not a full transpose of the meaning in the specification?

Some examples:
* The github project shows only a few instances for the word "must", the specification text  shows more examples of these requirements though. For example, in 3.1.2 it is stated that UserTransaction objects must be Referenceable and Serializable. The requirement does not appear in the Javadoc.
* Handling unchecked exceptions in beforeCompletion. Unchecked exceptions thrown by Synchronization objects should (since JTA 1.1) result in marking the transaction for rollback. The Javadoc does not describe that.
* The JTA specification has in  at least one case deviated from XA. Defined in 3.4.3 an XAResource is required to allow any thread to perform transaction association calls xa_start and xa_end calls for a specific branch, in XA that is not the case.

What is the recommended way to deal with these type of issues?

_______________________________________________ mailing list
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

_______________________________________________ mailing list
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

_______________________________________________ mailing list
To change your delivery options, retrieve your password, or unsubscribe from this list, visit

Back to the top