com.atomikos.icatch.jta.jsp

Class TransactionTag

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

javax.servlet.jsp.tagext.BodyTagSupport

com.atomikos.icatch.jta.jsp.TransactionTag

All Implemented Interfaces:

Serializable, javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.Tag, javax.servlet.jsp.tagext.TryCatchFinally

public final class TransactionTag
extends javax.servlet.jsp.tagext.BodyTagSupport
implements javax.servlet.jsp.tagext.TryCatchFinally

A JSP tag handler for transaction demarcation in a JSP page.

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.servlet.jsp.tagext.BodyTagSupport

bodyContent

Fields inherited from class javax.servlet.jsp.tagext.TagSupport

id, pageContext

Fields inherited from interface javax.servlet.jsp.tagext.BodyTag

EVAL_BODY_BUFFERED, EVAL_BODY_TAG

Fields inherited from interface javax.servlet.jsp.tagext.IterationTag

EVAL_BODY_AGAIN

Fields inherited from interface javax.servlet.jsp.tagext.Tag

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor and Description
TransactionTag()

Method Summary

Modifier and Type	Method and Description
void	doCatch(Throwable arg) This method is invoked by the JSP engine whenever there is an exception in the body.
void	doFinally() Invoked at the end of the tag.
int	doStartTag() Invoked before the body is evaluated.
void	setTimeout(String seconds) Sets the timeout for new transactions.

Methods inherited from class javax.servlet.jsp.tagext.BodyTagSupport

doAfterBody, doEndTag, doInitBody, getBodyContent, getPreviousOut, release, setBodyContent

Methods inherited from class javax.servlet.jsp.tagext.TagSupport

findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface javax.servlet.jsp.tagext.Tag

getParent, setPageContext, setParent

Constructor Detail

TransactionTag

public TransactionTag()

Method Detail

setTimeout

public void setTimeout(String seconds)

Sets the timeout for new transactions. Specified as an attribute in the JSP opening tag.

Parameters:

seconds - The timeout in seconds.

doStartTag

public int doStartTag()
               throws javax.servlet.jsp.JspException

Invoked before the body is evaluated. This method will start a new transaction.

Specified by:

doStartTag in interface javax.servlet.jsp.tagext.Tag

Overrides:

doStartTag in class javax.servlet.jsp.tagext.BodyTagSupport

Throws:

javax.servlet.jsp.JspException - On failure.

doCatch

public void doCatch(Throwable arg)
             throws Throwable

This method is invoked by the JSP engine whenever there is an exception in the body. In this case, the transaction will be marked for rollback.

Specified by:

doCatch in interface javax.servlet.jsp.tagext.TryCatchFinally

Parameters:

arg - The exception that has happened. This exception is re-raised after marking the transaction for rollback.

Throws:

Throwable

doFinally

public void doFinally()

Invoked at the end of the tag. This method will try to commit the transaction. If any exception happened, then the transaction will have been marked for rollback so commit will fail.

Specified by:

doFinally in interface javax.servlet.jsp.tagext.TryCatchFinally