API usage: Transaction.close

[Justin]

I am sorry if I have many questions, hopefully I can put the answers
back into the javadoc.

When would I want to use Transaction.close() over Transaction.commit()
or Transaction.rollback()? Must I always call Transaction.close()?
For example, is the 'correct' canonical transaction something like:

Transaction tx = paged.tx();
try { // do work within the transaciton
tx.get(...); tx.put(...);
..
tx.commit();
} catch (Exception ex) {
tx.rollback();
} finally {
tx.close();
}

From the implementation it seems like some kind of safety check if you
intend on reusing a single transaction object multiple times, but I
don't really see why I would ever need/want to call it.

[Hiram Chirino]

Yes it's mostly for a saftey check. The close() method is only there
to get some assertion support. Once, closed, the transaction will
throw errors if you try to use it.

--
Regards,
Hiram

Blog: http://hiramchirino.com

Open Source SOA
http://fusesource.com/