Package org.apache.taglibs.standard.tag.common.sql

Class TransactionTagSupport

java.lang.Object

jakarta.servlet.jsp.tagext.TagSupport

org.apache.taglibs.standard.tag.common.sql.TransactionTagSupport

All Implemented Interfaces:

IterationTag, JspTag, Tag, TryCatchFinally, Serializable

Direct Known Subclasses:

TransactionTag, TransactionTag

public abstract class TransactionTagSupport
extends TagSupport
implements TryCatchFinally

Tag handler for <Transaction> in JSTL.

Author:

Hans Bergsten

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	dataSourceSpecified
protected Object	rawDataSource

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

id, pageContext

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

EVAL_BODY_AGAIN

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

EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE

Constructor Summary

Constructors

Constructor	Description
TransactionTagSupport()

Method Summary

Modifier and Type	Method	Description
void	doCatch(Throwable t)	Rollbacks the transaction and rethrows the Throwable.
int	doEndTag()	Commits the transaction.
void	doFinally()	Restores the Connection to its initial state and closes it.
int	doStartTag()	Prepares for execution by setting the initial state, such as getting the Connection and preparing it for the transaction.
Connection	getSharedConnection()	Called by nested parameter elements to get a reference to the Connection.
void	release()	Release state.
void	setIsolation(String iso)	Setter method for the transaction isolation level.

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

doAfterBody, 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

Field Details

rawDataSource

protected Object rawDataSource

dataSourceSpecified

protected boolean dataSourceSpecified

Constructor Details

TransactionTagSupport

public TransactionTagSupport()

Method Details

doStartTag

public int doStartTag()
               throws JspException

Prepares for execution by setting the initial state, such as getting the Connection and preparing it for the transaction.

Specified by:

doStartTag in interface Tag

Overrides:

doStartTag in class TagSupport

Returns:

SKIP_BODY

Throws:

JspException - if an error occurs while processing this tag

See Also:

• Tag.doStartTag()

doEndTag

public int doEndTag()
             throws JspException

Commits the transaction.

Specified by:

doEndTag in interface Tag

Overrides:

doEndTag in class TagSupport

Returns:

EVAL_PAGE

Throws:

JspException - if an error occurs while processing this tag

See Also:

• Tag.doEndTag()

doCatch

public void doCatch(Throwable t)
             throws Throwable

Rollbacks the transaction and rethrows the Throwable.

Specified by:

doCatch in interface TryCatchFinally

Parameters:

t - The throwable exception navigating through this tag.

Throws:

Throwable - if the exception is to be rethrown further up the nest chain.

doFinally

public void doFinally()

Restores the Connection to its initial state and closes it.

Specified by:

doFinally in interface TryCatchFinally

release

public void release()

Description copied from class: TagSupport

Release state.

Specified by:

release in interface Tag

Overrides:

release in class TagSupport

See Also:

• Tag.release()

setIsolation

public void setIsolation(String iso)
                  throws JspTagException

Setter method for the transaction isolation level.

Throws:

JspTagException

getSharedConnection

public Connection getSharedConnection()

Called by nested parameter elements to get a reference to the Connection.