Bug 1019000 - Add information about starting transactions when annotation is used
Summary: Add information about starting transactions when annotation is used
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: JBoss Enterprise Application Platform 6
Classification: JBoss
Component: Documentation
Version: 6.2.0
Hardware: Unspecified
OS: Unspecified
unspecified
high
Target Milestone: post-GA
: EAP 6.3.0
Assignee: David Michael
QA Contact: Hayk Hovsepyan
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2013-10-14 22:24 UTC by Ondrej Chaloupka
Modified: 2014-11-23 23:16 UTC (History)
3 users (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Build Name: 14875, Development Guide-6.2-1 Build Date: 02-10-2013 13:20:00 Topic ID: 4301-155458 [Latest]
Last Closed: 2014-11-23 23:16:54 UTC
Type: Bug


Attachments (Terms of Use)

Description Ondrej Chaloupka 2013-10-14 22:24:56 UTC
Title: Lifecycle of a JTA Transaction

The text says: "Calling UserTransaction.begin() starts a new transaction.". That's true but it's more normal to use annotations and there is transaction started when an EJB method is called (driven by TransactionAttribute rules)

- plus mention that using UserTransaction object is just for BTM transactions. In CMT is not permitted.

Comment 1 Ondrej Chaloupka 2013-10-14 22:32:11 UTC
More point to this chapter:
- "In the next step, your transaction performs its work and makes changes to its state. " - this sentence is quite strange. Shouldn't be rahter 'your application performs its work'?
- "It calls UserTransaction.commit() or UserTransaction.rollback(). This is when the two-phase commit protocol (2PC) happens if you have enlisted more than one resource. " - the sentence 'This is when the two-phase commit protocol (2PC) happens if you have enlisted more than one resource.' seems to me being out of the context. Please reformulate it or delete it. It depends what it should explain.
- "After the commit or rollback completes, the transaction manager cleans up its records and removes information about your transaction." - it could be fine to specify where it removes info from liket "and removes information about your transaction from transaction log"
- "the Transaction Manager handles recovery when the underlying failure is resolved." - I think that it would be fine to mention something that explain that resource is available again afterwards - laike "...when underlying failuire is resolved and the resource is available again".

Comment 2 Misha H. Ali 2014-02-14 02:01:46 UTC
(In reply to Ondrej Chaloupka from comment #0)
> Title: Lifecycle of a JTA Transaction
> 
> The text says: "Calling UserTransaction.begin() starts a new transaction.".
> That's true but it's more normal to use annotations and there is transaction
> started when an EJB method is called (driven by TransactionAttribute rules)
> 
> - plus mention that using UserTransaction object is just for BTM
> transactions. In CMT is not permitted.



(In reply to Ondrej Chaloupka from comment #1)
> More point to this chapter:
> - "In the next step, your transaction performs its work and makes changes to
> its state. " - this sentence is quite strange. Shouldn't be rahter 'your
> application performs its work'?
> - "It calls UserTransaction.commit() or UserTransaction.rollback(). This is
> when the two-phase commit protocol (2PC) happens if you have enlisted more
> than one resource. " - the sentence 'This is when the two-phase commit
> protocol (2PC) happens if you have enlisted more than one resource.' seems
> to me being out of the context. Please reformulate it or delete it. It
> depends what it should explain.
> - "After the commit or rollback completes, the transaction manager cleans up
> its records and removes information about your transaction." - it could be
> fine to specify where it removes info from liket "and removes information
> about your transaction from transaction log"
> - "the Transaction Manager handles recovery when the underlying failure is
> resolved." - I think that it would be fine to mention something that explain
> that resource is available again afterwards - laike "...when underlying
> failuire is resolved and the resource is available again".

Comment 5 Hayk Hovsepyan 2014-09-22 08:29:44 UTC
Verified on Revision 6.3.0-31


Note You need to log in before you can comment on or make changes to this bug.