public abstract class ForTokensSupport extends LoopTagSupport
Support for tag handlers for <forTokens>, the tokenizing iteration tag in JSTL 1.0. This class extends LoopTagSupport and provides ForTokens-specific functionality. The rtexprvalue and expression-evaluating libraries each have handlers that extend this class.
LoopTagSupport
,
Serialized FormModifier and Type | Field and Description |
---|---|
protected int |
currentIndex |
protected String |
delims |
protected Object |
items |
protected StringTokenizer |
st |
begin, beginSpecified, deferredExpression, end, endSpecified, itemId, statusId, step, stepSpecified
id, pageContext
EVAL_BODY_AGAIN
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
Constructor and Description |
---|
ForTokensSupport() |
Modifier and Type | Method and Description |
---|---|
protected String |
getDelims()
Get the delimiter for string tokens.
|
protected boolean |
hasNext()
Returns information concerning the availability of more items
over which to iterate.
|
protected Object |
next()
Returns the next object over which the tag should iterate.
|
protected void |
prepare()
Prepares for a single tag invocation.
|
void |
release()
Releases any resources this LoopTagSupport may have (or inherit).
|
doAfterBody, doCatch, doFinally, doStartTag, getCurrent, getLoopStatus, setVar, setVarStatus, validateBegin, validateEnd, validateStep
doEndTag, findAncestorWithClass, getId, getParent, getValue, getValues, removeValue, setId, setPageContext, setParent, setValue
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
doEndTag, getParent, setPageContext, setParent
protected Object items
protected String delims
protected StringTokenizer st
protected int currentIndex
protected void prepare() throws JspTagException
LoopTagSupport
Prepares for a single tag invocation. Specifically, allows subclasses to prepare for calls to hasNext() and next(). Subclasses can assume that prepare() will be called once for each invocation of doStartTag() in the superclass.
prepare
in class LoopTagSupport
JspTagException
protected boolean hasNext() throws JspTagException
LoopTagSupport
Returns information concerning the availability of more items over which to iterate. This method must be provided by concrete subclasses of LoopTagSupport to assist the iterative logic provided by the supporting base class.
See next for more information about the purpose and expectations behind this tag.
hasNext
in class LoopTagSupport
JspTagException
LoopTagSupport.next()
protected Object next() throws JspTagException
LoopTagSupport
Returns the next object over which the tag should iterate. This method must be provided by concrete subclasses of LoopTagSupport to inform the base logic about what objects it should iterate over.
It is expected that this method will generally be backed by an Iterator, but this will not always be the case. In particular, if retrieving the next object raises the possibility of an exception being thrown, this method allows that exception to propagate back to the JSP container as a JspTagException; a standalone Iterator would not be able to do this. (This explains why LoopTagSupport does not simply call for an Iterator from its subtags.)
next
in class LoopTagSupport
JspTagException
- for other, unexpected exceptionspublic void release()
LoopTagSupport
release
in interface Tag
release
in class LoopTagSupport
Tag.release()
protected String getDelims()
getDelims
in class LoopTagSupport
Copyright © 2017 JBoss by Red Hat. All rights reserved.