users@jta-spec.java.net

[jta-spec users] Re: latest/final rev of JTA 1.2 spec and Javadoc

From: Paul Parkinson <PAUL.PARKINSON_at_ORACLE.COM>
Date: Tue, 26 Mar 2013 23:46:27 -0400

I found the mailto:Transactional.If mentioned. I'll have the rev out tomorrow...

On Mar 26, 2013, at 9:26 PM, Paul Parkinson <paul.parkinson_at_oracle.com> wrote:

> Thank you Ian. I've made updates that Linda caught (below) along with these that you've sent.
>
> I actually couldn't find the "occurence in the where an @Transactional annotation had mistakenly got a "mailto:Transactional.If" hyperlink associated with it. " you mention though. Sorry, can you be more specific? I'm asking other internally to check as well as it's quite likely I'm just missing it somehow.
>
> I'm also just updating the footer to "Maintenance Review"
>
> Thanks,
> Paul
>
> LIndas
> "
>
> P. 8 still has the local variable inconsistency in the last line of the
> example.
>
> p. 22 code at top of page belongs on previous page.
>
> p. 25 3rd line from bottom: something went wrong with the line breaks here
>
> p.29-32 formatting problems. (Ditto.)
>
> Javadocs for the Transactional annotation would benefit from some paragraph
> breaks.
>
> "
>
> On Mar 25, 2013, at 6:06 PM, Ian Robinson wrote:
>
>> Paul. I noticed an inconsistency between the PDF and the Javadoc for @Transactional.
>> The Javadoc states:
>> If an attempt is made to call any method of the UserTransaction interface from within the scope of a bean or method annotated with @Transactional and a Transactional.TxType other than NOT_SUPPORTED or NEVER, an IllegalStateException must be thrown.
>>
>> The PDF states:
>> If an attempt is made to call any method of the UserTransaction interface from within a bean or method annotated with @Transactional and a Transactional.TxType other than NOT_SUPPORTED or NEVER, an IllegalStateException must be thrown.
>>
>> I think the Javadoc version better conveys the intention and so the PDF is the one I'd recommend changing to become consistent.
>>
>> I also found an occurence in the where an @Transactional annotation had mistakenly got a "mailto:Transactional.If" hyperlink associated with it.
>>
>> I noticed that the pseudo-code on P8 has regressed - you fixed it in an earlier draft:
>>
>> public void updateData() {
>> // Obtain the default initial JNDI context.
>> Context context = new InitialContext();
>> // Look up the UserTransaction object.
>> UserTransaction userTransaction = (UserTransaction)
>> context.lookup("java:comp/UserTransaction");
>> // Start a transaction.
>> userTransaction.begin();
>> // ...
>> // Perform transactional operations on data
>> // Commit the transaction.
>> tx.commit();
>>
>>
>>
>>
>> Regards,
>> Ian
>>
>>
>>
>>
>> From: Paul Parkinson <paul.parkinson_at_oracle.com>
>> To: users_at_jta-spec.java.net,
>> Cc: Bill Shannon <bill.shannon_at_oracle.com>, Kevin Sutter <sutter_at_us.ibm.com>, Joseph Bergmark <bergmark_at_us.ibm.com>
>> Date: 24/03/2013 16:27
>> Subject: [jta-spec users] latest/final rev of JTA 1.2 spec and Javadoc
>>
>>
>>
>> http://java.net/projects/jta-spec/sources/spec-source-repository/content/JTA1.2Specification.pdf?rev=10
>> http://java.net/projects/jta-spec/sources/spec-source-repository/content/JTA1.2Javadoc.zip?rev=10
>>
>> Regards,
>> Paul
>>
>>
>> Unless stated otherwise above:
>> IBM United Kingdom Limited - Registered in England and Wales with number 741598.
>> Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU
>