ChooseTag (Jakarta Standard Tag Library Implementation 3.0.1 API)

java.lang.Object
- jakarta.servlet.jsp.tagext.TagSupport
- - org.apache.taglibs.standard.tag.common.core.ChooseTag

All Implemented Interfaces:

jakarta.servlet.jsp.tagext.IterationTag, jakarta.servlet.jsp.tagext.JspTag, jakarta.servlet.jsp.tagext.Tag, Serializable
```
public class ChooseTag
extends jakarta.servlet.jsp.tagext.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 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

ChooseTag()

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`int`	`doStartTag()`
`boolean`	`gainPermission()`	Returns status indicating whether a subtag should run or not.
`void`	`release()`
`void`	`subtagSucceeded()`	Called by a subtag to indicate that it plans to evaluate its body.

Methods inherited from class jakarta.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()
```
    Specified by:
    
    release in interface jakarta.servlet.jsp.tagext.Tag
    
    Overrides:
    
    release in class jakarta.servlet.jsp.tagext.TagSupport
  - 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 jakarta.servlet.jsp.JspException
```
    Specified by:
    
    doStartTag in interface jakarta.servlet.jsp.tagext.Tag
    
    Overrides:
    
    doStartTag in class jakarta.servlet.jsp.tagext.TagSupport
    
    Throws:
    
    jakarta.servlet.jsp.JspException