dsp:rollbackTransaction
causes the tasks associated with the current transaction to halt processing and return to their pre-transaction state. This tag tracks whether the rollback action is successful and when it is not, provides a Throwable
exception object. This tag creates an EL variable that can be referenced by later tags, and provides access to the referenced object’s 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 what resources can access the named EL variable. 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 rollback transaction operation. A call to isSuccess
returns either true.
exception
The exception
property identifies the Throwable
exception object produced when a transaction fails to roll back properly. A call to getException
returns the exception object.
Example
<dsp:rollbackTransaction var="rollbackXA"/>
<c:choose>
<c:when test="${rollbackXA.success}">
Your band uniform order was canceled.
</c:when>
<c:otherwise>
Your band uniform order could not be canceled. Here's why:
<c:out value="${rollbackXA.exception}"/>
</c:otherwise
</c:choose>
In this example, if a particular transaction is successfully rolled back, the user sees the message Your band uniform order was canceled
. If the transaction is not successfully rolled back, the user sees the second message string Your band uniform order was canceled. Here's why:
and the exception.