This Confluence has been LDAP enabled, if you are an ASF Committer, please use your LDAP Credentials to login. Any problems file an INFRA jira ticket please.

Child pages
  • iterator
Skip to end of metadata
Go to start of metadata

Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works.

The id attribute is deprecated in Struts 2.1.x, and has been replaced by the var attribute.

The begin, end and step attributes are only available from 2.1.7 on


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.


Dynamic Attributes Allowed:








begin false 0 false Integer if specified the iteration will start on that index
end false Size of the 'values' List or array, or 0 if 'step' is negative false Integer if specified the iteration will end on that index(inclusive)
status false false false Boolean If specified, an instanceof IteratorStatus will be pushed into stack upon each iteration
step false 1 false Integer if specified the iteration index will be increased by this value on each iteration. It can be a negative value, in which case 'begin' must be greater than 'end'
value false false String the iteratable source to iterate over, else an the object itself will be put into a newly created List
var false false String Name used to reference the value pushed into the Value Stack


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.

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'
<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:

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

<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">
  <th>Days of the week</th>

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

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:

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

 <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).

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

     <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

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

<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.

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

<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

Error rendering macro 'code': Invalid value specified for parameter 'java.lang.NullPointerException'

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

  • No labels


  1. Change "java.util.Collection, java.util.Iterator," to "java.util.Collection, java.util.Iterator, java.util.Enumeration, java.util.Map, array."
    Change "instanceof" to "instance of".
    Change "else an the object" to "else the object".
    Change "and then calls its" to "and the call its".
    Change "used to create a IteratorStatus object" to "used to create an IteratorStatus object".
    Change "seperate" to "separate".
    Change ">s:property />" to "<s:property />".
    Add missing "</s:action>" to second-to-last code sample.
    In the last code sample, there are five elements in the iterator, therefore there must be five indexes, either 0-4 or 1-5. In other words, change the line:

    <!-- current iteration value (0, 1, ... 5) -->

    1. The items that needed correcting have been corrected ("the call its", "missing </s:action" not errors).

  2. Description of attribute id should be marked with Struts version, deprecated since Struts 2.1.x, it is a common mistake for new Struts developers

    1. Indeed. Since I don't have access to the source repository atm, I've added a note on tope of the page. Thanks for the heads up.

  3. The section where the action and iterator tag are together is very hard to read. Mostly because there are three different things called "entries". It also doesn't help that there's no java code to go with the example. I admit that I'm a Struts2 newbie, but it took me about 20-30 minutes of trial and error to get it working.
    <s:action name="entries" var="entries"/>
               <s:iterator value="#entries.entries" >...