Apache Struts 2 Documentation > Home > Guides > Tag Developers Guide > Struts Tags > Tag Reference > Generic Tag Reference > iterator
Added by digi9ten, last edited by Ted Husted on Sep 02, 2006  (view change)
Please make sure you have read the Tag Syntax document and understand how tag attribute syntax works.

Description

Content pulled from external source. Click here to refresh.

Iterator will iterate over a value. An iterable value can be either of: java.util.Collection, java.util.Iterator,

Parameters

Content pulled from external source. Click here to refresh.

Name

Required

Default

Type

Description

status false false Boolean if specified, an instanceof IteratorStatus will be pushed into stack upon each iteration
value false   Object/String the iteratable source to iterate over, else an the object itself will be put into a newly created List
id false   Object/String id for referencing element. For UI and form tags it will be used as HTML id attribute

Examples

Content pulled from external source. Click here to refresh.

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.

Content pulled from external source. Click here to refresh.
<s:iterator value="days">
  <p>day is: <s:property/></p>
</s:iterator>
Content pulled from external source. Click here to refresh.

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 a IteratorStatus object, which in this example, its odd() method is used to alternate row colours:

Content pulled from external source. Click here to refresh.
<s:bean name="org.apache.struts2.example.IteratorExample" id="it">
  <s:param name="day" value="'foo'"/>
  <s:param name="day" value="'bar'"/>
</s:bean>
<p/>
<table border="0" cellspacing="0" cellpadding="1">
<tr>
  <th>Days of the week</th>
</tr>
<p/>
<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>
Content pulled from external source. Click here to refresh.

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 seperate the users using a comma:

Content pulled from external source. Click here to refresh.
<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>
			<td>
				<s:iterator value="users" status="userStatus">
					<s:property value="fullName" /><s:if test="!#userStatus.last">,</s:if>
				</s:iterator>
			</td>
		</tr>
	</s:iterator>
Content pulled from external source. Click here to refresh.

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

Content pulled from external source. Click here to refresh.
<s:action name="entries" id="entries"/>
		<s:iterator value="#entries.entries" >
			<s:property value="name" />
			<s:property />
			<s:push value="...">
				<s:action name="edit" id="edit" >
					<s:param name="entry" value="[0]" />
				</s:action>
			</push>
		</s:iterator>
Content pulled from external source. Click here to refresh.

To simulate a simple loop with iterator tag, the following could be done. It does the loop 5 times.

Content pulled from external source. Click here to refresh.
<s:iterator status="stat" value="{1,2,3,4,5}" >
   <!-- grab the index (start with 0 ... ) -->
   <s:property value="#stat.index" />
   
   <!-- grab the top of the stack which should be the -->
   <!-- current iteration value (0, 1, ... 5) -->
   <s:property value="top" />
</s:iterator>