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

java.lang.Object
  extended by javax.servlet.jsp.tagext.TagSupport
      extended by 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
CatchTag()
           
 
Method Summary
 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)


Copyright © 2008 Mort Bay Consulting. All Rights Reserved.