org.apache.taglibs.standard.tag.common.core

Class CatchTag

java.lang.Object

javax.servlet.jsp.tagext.TagSupport

org.apache.taglibs.standard.tag.common.core.CatchTag

All Implemented Interfaces:

Serializable, IterationTag, JspTag, Tag, TryCatchFinally

public class CatchTag
extends TagSupport
implements TryCatchFinally

Tag handler for <catch> in JSTL 1.0.

<catch> simply catches any Throwables that occur in its body and optionally exposes them.

Author:

Shawn Bayern

See Also:

Serialized Form

Field Summary

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

id, pageContext

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
CatchTag()

Method Summary

Modifier and Type	Method and Description
void	doCatch(Throwable t) Invoked if a Throwable occurs while evaluating the BODY inside a tag or in any of the following methods: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() and BodyTag.doInitBody().
void	doFinally() Invoked in all cases after doEndTag() for any class implementing Tag, IterationTag or BodyTag.
int	doStartTag() Default processing of the start tag, returning SKIP_BODY.
void	release() Release state.
void	setVar(String var)

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

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

Constructor Detail

CatchTag

public CatchTag()

Method Detail

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()

doStartTag

public int doStartTag()

Description copied from class: TagSupport

Default processing of the start tag, returning SKIP_BODY.

Specified by:

doStartTag in interface Tag

Overrides:

doStartTag in class TagSupport

Returns:

SKIP_BODY

See Also:

Tag.doStartTag()

doCatch

public void doCatch(Throwable t)

Description copied from interface: TryCatchFinally

Invoked if a Throwable occurs while evaluating the BODY inside a tag or in any of the following methods: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() and BodyTag.doInitBody().

This method is not invoked if the Throwable occurs during one of the setter methods.

This method may throw an exception (the same or a new one) that will be propagated further up the nest chain. If an exception is thrown, doFinally() will be invoked.

This method is intended to be used to respond to an exceptional condition.

Specified by:

doCatch in interface TryCatchFinally

Parameters:

t - The throwable exception navigating through this tag.

doFinally

public void doFinally()

Description copied from interface: TryCatchFinally

Invoked in all cases after doEndTag() for any class implementing Tag, IterationTag or BodyTag. This method is invoked even if an exception has occurred in the BODY of the tag, or in any of the following methods: Tag.doStartTag(), Tag.doEndTag(), IterationTag.doAfterBody() and BodyTag.doInitBody().

This method is not invoked if the Throwable occurs during one of the setter methods.

This method should not throw an Exception.

This method is intended to maintain per-invocation data integrity and resource management actions.

Specified by:

doFinally in interface TryCatchFinally

setVar

public void setVar(String var)