iterator的用法

在说明s:iterator标签的使用前，先了解下struts2中的Value Stack。这里参考了webwork中对Value Stack的描述，由于struts2是在webwork的基础上进行升级的，因此webwork对于Value Stack的表述同样适用于struts2。在这里不描述Value Stack具体做什么，但有两点需要注意：

 一个value stack本质上是一个List； 
在栈中调用[n]将返回一个从位置n开始的子栈； 
对于2举个例子说明。假定Value Stack包含了[model,action,others]，那么

[0] --- 返回 [model,action,others]； 
[1] --- 返回 [action,others]； 
[2] --- 返回 [others]; 
现在将开始介绍s:iterator的一些使用。以下代码片段均在开发环境eclipse3.4 wtp、tomcat5.5、jdk5上使用struts2.1.6测试通过。

1) 、访问 days 

defined  List<String>  days   ["Monday","Thursday","Friday","Sunday"] 

view plaincopy to clipboardprint?
<s:iterator value="days"><s:property /></s:iterator>  
<s:iterator value="days"><s:property /></s:iterator> 

2) 、使用 top 关键字使用(过滤掉Monday) 

defined  List<String>  days   ["Monday","Thursday","Friday","Sunday"] 

view plaincopy to clipboardprint?
<s:iterator value="days">  
            <s:if test="top!='Monday'">  
                <s:property />  
            </s:if>  
        </s:iterator>  
<s:iterator value="days">
            <s:if test="top!='Monday'">
                <s:property />
            </s:if>
        </s:iterator> 

top 指代当前迭代元素，可以为对象； 
这里的top可用[0].top替代，但不能使用[0]。[0]代表整个栈对象。如果单纯调用[0]将会调用其toString()方法输出对象信息；

3)、使用 last / first 关键字使用 

defined  String[][] aTs = { { "一", "二", "三", "四" },{ "一一", "二二", "三三", "四四"} }; 

view plaincopy to clipboardprint?
<!--遍历二维数组，The trick here is to use 'top' as the value for the inner iterator-->  
          <s:iterator value="aTs" status="of">  
          <s:if test="#of.last"><br/></s:if>  
          <s:iterator value="top">  
<!--亦可用[0].top替代。如果单纯用[0],则会同时打印该处栈对象信息-->  
         <s:property />  
          </s:iterator>  
          </s:iterator>  
<!--遍历二维数组，The trick here is to use 'top' as the value for the inner iterator-->
          <s:iterator value="aTs" status="of">
       <s:if test="#of.last"><br/></s:if>
       <s:iterator value="top">
<!--亦可用[0].top替代。如果单纯用[0],则会同时打印该处栈对象信息-->
   <s:property />
       </s:iterator>
          </s:iterator>   


iterator 标签中的status属性代表当前迭代的位置； 
#of.last用于判断当前是否跌到的最后一个元素； 
last返回一个boolean类型; 
first 返回一个boolean类型; 
4)、使用 odd / even 关键字 

下面的例子要实现每行输出颜色不同的效果。

defined  List<String>  days   ["Monday","Thursday","Friday","Sunday"] 

view plaincopy to clipboardprint?
       <!--奇数行显示为红色,偶数行显示为绿色-->  
       <s:iterator value="days" status="offset">  
    <s:else>  
        <s:if test="#offset.odd==true">  
            <li style="color: red" mce_style="color: red"><s:property /></li>  
        </s:if>  
        <s:else>  
            <li><s:property /></li>  
        </s:else>  
    </s:else>  
</s:iterator>  
        <!--奇数行显示为红色,偶数行显示为绿色-->
        <s:iterator value="days" status="offset">
  <s:else>
   <s:if test="#offset.odd==true">
    <li style="color: red" mce_style="color: red"><s:property /></li>
   </s:if>
   <s:else>
    <li><s:property /></li>
   </s:else>
  </s:else>
 </s:iterator> 

odd关键字用来判断当前迭代位置是否为奇数行。odd返回boolean类型; 
evne关键字用来判断当前迭代位置是否为偶数行。even返回boolean类型 
5)、总结下，当声明iterator的status属性时，通过#statusName.method 可以使用以下方法:

even : boolean - 如果当前迭代位置是偶数返回true 
odd : boolean - 如果当前迭代位置是奇数返回true 
count : int - 返回当前迭代位置的计数(从1开始) 
index : int - 返回当前迭代位置的编号(从0开始) 
first : boolean - 如果当前迭代位置是第一位时返回true 
last : boolean - 如果当前迭代位置是最后一位时返回true 
modulus(operand : int) : int - 返回当前计数(从1开始)与指定操作数的模数 

假定输出一个List
<s:iterator value="list" status="L">
   <s:property value="#L.index"/>
</s:iterator>


6)、最后再来看下在iterator中调用value stack的用法。 

假定countries是一个List对象，每一个country有一个name属性和一个citys List对象，并且每一个city也有一个name属性 。那么我们想要在迭代cities是访问countries的name属性就的用如下方式：


view plaincopy to clipboardprint?
<s:iterator value="countries">  
    <s:iterator value="cities">  
        <s:property value="name"/>, <s:property value="[1].name"/><br>  
    </s:iterator>  
</s:iterator>  
           <s:iterator value="countries">
               <s:iterator value="cities">
                   <s:property value="name"/>, <s:property value="[1].name"/><br>
               </s:iterator>
           </s:iterator> 

这里的 <ww:property value="name"/>取的是ctiy.name;<ww:property value="[1].name"/>取得是country.name 
<ww:property value="[1].name"/> 等价于 <ww:property value="[1].top.name"/> 
we refer to a specific position on the stack: '[1]'. The top of the stack, position 0, contains the current city, pushed on by the inner iterator; position 1 contains the current country, pushed there by the outer iterator.(city处于当前栈，即top或者[0],而[1]指明了外层iterator对象，即country) 
 '[n]'标记引用开始位置为n的子栈（sub-stack），而不仅仅是位置n处的对象。因此'[0]'代表整个栈，而'[1]'是除top对象外所有的栈元素。