| Summary: | Add information about starting transactions when annotation is used | ||
|---|---|---|---|
| Product: | [JBoss] JBoss Enterprise Application Platform 6 | Reporter: | Ondrej Chaloupka <ochaloup> |
| Component: | Documentation | Assignee: | David Michael <dmichael> |
| Status: | CLOSED CURRENTRELEASE | QA Contact: | Hayk Hovsepyan <hhovsepy> |
| Severity: | high | Docs Contact: | |
| Priority: | unspecified | ||
| Version: | 6.2.0 | CC: | dmichael, hhovsepy, twells |
| Target Milestone: | post-GA | Keywords: | Documentation |
| Target Release: | EAP 6.3.0 | ||
| Hardware: | Unspecified | ||
| OS: | Unspecified | ||
| Whiteboard: | |||
| Fixed In Version: | Doc Type: | Bug Fix | |
| Doc Text: | Story Points: | --- | |
| 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 |
| Regression: | --- | Mount Type: | --- |
| Documentation: | --- | CRM: | |
| Verified Versions: | Category: | --- | |
| oVirt Team: | --- | RHEL 7.3 requirements from Atomic Host: | |
| Cloudforms Team: | --- | Target Upstream Version: | |
|
Description
Ondrej Chaloupka
2013-10-14 22:24:56 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". (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". Verified on Revision 6.3.0-31 |