javax.servlet.jsp.jstl.core
Interface LoopTag

All Superinterfaces:
javax.servlet.jsp.tagext.JspTag, javax.servlet.jsp.tagext.Tag
All Known Implementing Classes:
LoopTagSupport

public interface LoopTag
extends javax.servlet.jsp.tagext.Tag

JSTL allows developers to write custom iteration tags by implementing the LoopTag interface. This is not to be confused with javax.servlet.jsp.tagext.IterationTag as defined in JSP 1.2. LoopTag establishes a mechanism for iteration tags to be recognized and for type-safe implicit collaboration with custom subtags.

In most cases, it will not be necessary to implement this interface manually, for a base support class (LoopTagSupport) is provided to facilitate implementation.

Author:
Shawn Bayern

Field Summary
 
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Method Summary
 java.lang.Object getCurrent()
          Retrieves the current item in the iteration.
 LoopTagStatus getLoopStatus()
          Retrieves a 'status' object to provide information about the current round of the iteration.
 
Methods inherited from interface javax.servlet.jsp.tagext.Tag
doEndTag, doStartTag, getParent, release, setPageContext, setParent
 

Method Detail

getCurrent

public java.lang.Object getCurrent()
Retrieves the current item in the iteration. Behaves idempotently; calling getCurrent() repeatedly should return the same Object until the iteration is advanced. (Specifically, calling getCurrent() does not advance the iteration.)

Returns:
the current item as an object

getLoopStatus

public LoopTagStatus getLoopStatus()
Retrieves a 'status' object to provide information about the current round of the iteration.

Returns:
The LoopTagStatus for the current LoopTag.


Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.