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