Class IteratorComponent

  extended by org.apache.struts2.components.Component
      extended by org.apache.struts2.components.ContextBean
          extended by org.apache.struts2.components.IteratorComponent

public class IteratorComponent
extends ContextBean

Iterator will iterate over a value. An iterable value can be any of: java.util.Collection, java.util.Iterator, java.util.Enumeration, java.util.Map, or an array.

The following example retrieves the value of the getDays() method of the current object on the value stack and uses it to iterate over. The <s:property/> tag prints out the current value of the iterator.

 <s:iterator value="days">
   <p>day is: <s:property/></p>

The following example uses a Bean tag and places it into the ActionContext. The iterator tag will retrieve that object from the ActionContext and then calls its getDays() method as above. The status attribute is also used to create an IteratorStatus object, which in this example, its odd() method is used to alternate row colours:


 <s:bean name="org.apache.struts2.example.IteratorExample" var="it">
   <s:param name="day" value="'foo'"/>
   <s:param name="day" value="'bar'"/>

<table border="0" cellspacing="0" cellpadding="1"> <tr> <th>Days of the week</th> </tr>

<s:iterator value="#it.days" status="rowstatus"> <tr> <s:if test="#rowstatus.odd == true"> <td style="background: grey"><s:property/></td> </s:if> <s:else> <td><s:property/></td> </s:else> </tr> </s:iterator> </table>

The next example will further demonstrate the use of the status attribute, using a DAO obtained from the action class through OGNL, iterating over groups and their users (in a security context). The last() method indicates if the current object is the last available in the iteration, and if not, we need to separate the users using a comma:


  <s:iterator value="groupDao.groups" status="groupStatus">
      <tr class="<s:if test="#groupStatus.odd == true ">odd</s:if><s:else>even</s:else>">
          <td><s:property value="name" /></td>
          <td><s:property value="description" /></td>
              <s:iterator value="users" status="userStatus">
                  <s:property value="fullName" /><s:if test="!#userStatus.last">,</s:if>


The next example iterates over a an action collection and passes every iterator value to another action. The trick here lies in the use of the '[0]' operator. It takes the current iterator value and passes it on to the edit action. Using the '[0]' operator has the same effect as using <s:property />. (The latter, however, does not work from inside the param tag).


      <s:action name="entries" var="entries"/>
      <s:iterator value="#entries.entries" >
          <s:property value="name" />
          <s:property />
          <s:push value="...">
              <s:action name="edit" var="edit" >
                  <s:param name="entry" value="[0]" />


A loop that iterates 5 times

 <s:iterator var="counter" begin="1" end="5" >
    <!-- current iteration value (1, ... 5) -->
    <s:property value="top" />


Another way to create a simple loop, similar to JSTL's <c:forEach begin="..." end="..." ...> is to use some OGNL magic, which provides some under-the-covers magic to make 0-n loops trivial. This example also loops five times.

 <s:iterator status="stat" value="(5).{ #this }" >
    <s:property value="#stat.count" /> <!-- Note that "count" is 1-based, "index" is 0-based. -->


A loop that iterates over a partial list

 <s:iterator value="{1,2,3,4,5}" begin="2" end="4" >
    <!-- current iteration value (2,3,4) -->
    <s:property value="top" />


Field Summary
protected  java.lang.Integer begin
protected  java.lang.String beginStr
protected  java.lang.Integer end
protected  java.lang.String endStr
protected  java.util.Iterator iterator
protected  java.lang.Object oldStatus
protected  IteratorStatus status
protected  java.lang.String statusAttr
protected  IteratorStatus.StatusState statusState
protected  java.lang.Integer step
protected  java.lang.String stepStr
protected  java.lang.String value
Fields inherited from class org.apache.struts2.components.ContextBean
Fields inherited from class org.apache.struts2.components.Component
actionMapper, COMPONENT_STACK, parameters, stack, throwExceptionOnELFailure
Constructor Summary
IteratorComponent(ValueStack stack)
Method Summary
 boolean end( writer, java.lang.String body)
          Callback for the end tag of this component.
 void setBegin(java.lang.String begin)
 void setEnd(java.lang.String end)
 void setStatus(java.lang.String status)
 void setStep(java.lang.String step)
 void setValue(java.lang.String value)
 boolean start( writer)
          Callback for the start tag of this component.
Methods inherited from class org.apache.struts2.components.ContextBean
getVar, putInContext, setId, setVar
Methods inherited from class org.apache.struts2.components.Component
addAllParameters, addParameter, altSyntax, altSyntax, completeExpressionIfAltSyntax, copyParams, determineActionURL, determineNamespace, end, fieldError, findAncestor, findString, findString, findStringIfAltSyntax, findValue, findValue, findValue, getComponentStack, getParameters, getStack, popComponentStack, setActionMapper, setThrowExceptionsOnELFailure, stripExpressionIfAltSyntax, stripExpressionIfAltSyntax, toString, usesBody
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail


protected java.util.Iterator iterator


protected IteratorStatus status


protected java.lang.Object oldStatus


protected IteratorStatus.StatusState statusState


protected java.lang.String statusAttr


protected java.lang.String value


protected java.lang.String beginStr


protected java.lang.Integer begin


protected java.lang.String endStr


protected java.lang.Integer end


protected java.lang.String stepStr


protected java.lang.Integer step
Constructor Detail


public IteratorComponent(ValueStack stack)
Method Detail


public boolean start( writer)
Description copied from class: Component
Callback for the start tag of this component. Should the body be evaluated?

start in class Component
writer - the output writer.
true if the body should be evaluated


public boolean end( writer,
                   java.lang.String body)
Description copied from class: Component
Callback for the end tag of this component. Should the body be evaluated again?

NOTE: will pop component stack.

end in class Component
writer - the output writer.
body - the rendered body.
true if the body should be evaluated again


public void setStatus(java.lang.String status)


public void setValue(java.lang.String value)


public void setBegin(java.lang.String begin)


public void setEnd(java.lang.String end)


public void setStep(java.lang.String step)

Copyright © 2000-2011 Apache Software Foundation. All Rights Reserved.