The dsp:beginTransaction tag initiates a transaction and tracks whether the transaction is created successfully. Initiation failures are captured by the tag as a Throwable exception object. This tag creates an EL variable that enables later tags to reference the transaction access its success and exception properties.
Attributes
TagVariable:varorid(Required)
You must define an EL variable or scripting variable:
Attribute | Description |
|---|---|
| Names an EL variable. When you use |
| Names a scripting variable, which scriptlets and expressions can access at runtime. |
VariableScope:scope
The scope attribute determines where the object identified by the var attribute is stored and what resources can access it. Options include: page, request, session, or application. Omitting this attribute causes the default, page, to be used.
Properties
success
The success property specifies the status of the start transaction operation. A call to isSuccess returns true.
exception
The exception property identifies the Throwable exception object produced when a transaction does not start properly. A call to getException returns the exception object.
Example
<dsp:beginTransaction var="beginXA"/>
<c:choose>
<c:when test="${beginXA.success}">
The transaction was started successfully<br/>
</c:when>
<c:otherwise>
Transaction failed due to this exception:
<c:out value="${beginXA.exception}"/>
</c:otherwise>
</c:choose>
In this example, the tag causes a transaction to begin. If the call is successful, the user sees the message The transaction was started successfully. If the call fails, the user sees the message Transaction failed due to this exception and the exception is displayed.
