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

java.lang.Object
  extended by javax.servlet.jsp.tagext.TagSupport
      extended by org.apache.taglibs.standard.tag.common.core.ChooseTag
All Implemented Interfaces:
Serializable, IterationTag, JspTag, Tag

public class ChooseTag
extends TagSupport

Tag handler for <choose> in JSTL.

<choose> is a very simple tag that acts primarily as a container; it always includes its body and allows exactly one of its child <when> tags to run. Since this tag handler doesn't have any attributes, it is common.core to both the rtexprvalue and expression- evaluating versions of the JSTL library.

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
ChooseTag()
           
 
Method Summary
 int doStartTag()
          Default processing of the start tag, returning SKIP_BODY.
 boolean gainPermission()
          Returns status indicating whether a subtag should run or not.
 void release()
          Release state.
 void subtagSucceeded()
          Called by a subtag to indicate that it plans to evaluate its body.
 
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

ChooseTag

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

gainPermission

public boolean gainPermission()
Returns status indicating whether a subtag should run or not.

Returns:
true if the subtag should evaluate its condition and decide whether to run, false otherwise.

subtagSucceeded

public void subtagSucceeded()
Called by a subtag to indicate that it plans to evaluate its body.


doStartTag

public int doStartTag()
               throws JspException
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
Throws:
JspException - if an error occurs while processing this tag
See Also:
Tag.doStartTag()


Copyright © 2008 Mort Bay Consulting. All Rights Reserved.