JSTL循环标签foreach

迭代

在 Web 应用程序环境中，迭代主要用于访存和显示数据集，通常是以列表或表中的一系列行的形式显示。实现迭代内容的主要 JSTL 操作是 <c:forEach> 定制标记。该标记支持两种不同样式的迭代：整数范围上的迭代（类似 Java 语言的 for 语句）和集合上的迭代（类似 Java 语言的 Iterator 和 Enumeration 类）。

进行整数范围迭代用到了清单 1 中所示的 <c:forEach> 标记的语法。 begin 和 end 属性要么是静态整数值，要么是可以得出整数值的表达式。它们分别指定迭代索引的初始值以及迭代索引的终止值。当使用 <c:forEach> 在整数范围内进行迭代时，这两个属性是必需的，而其它所有属性都是可选的。


清单 1. 通过 <c:forEach> 操作进行数字迭代的语法
查看复制到剪切板打印

<c:forEach var="   
        name" varStatus="  
        name"   
    begin="   
        expression" end="  
        expression" step="  
        expression">   
     
        body content   
</c:forEach>  

<c:forEach var="
        name" varStatus="
        name"
    begin="
        expression" end="
        expression" step="
        expression">
  
        body content
</c:forEach>

当出现 step 时，它也必须是整数值。它指定每次迭代后索引的增量。这样，迭代索引从 begin 属性的值开始，以 step 属性的值为增量进行递增，在迭代索引超过 end 属性的值时停止迭代。注：如果省略了 step 属性，那么步长缺省为 1。

如果指定了 var 属性，那么将会创建一个带有指定名称的并限定了作用域的变量，并将每次迭代的当前索引值赋给该变量。这一限定了作用域的变量具有嵌套式可视性 ― 只可以在 <c:forEach> 标记体内对其进行访问。（我们很快将讨论可选属性 varStatus 的用法。）清单 2 显示了对一组固定整数值进行迭代的 <c:forEach> 操作示例。


清单 2. 使用 <c:forEach> 标记来生成表列数据，这些数据对应于某一范围内的数值
查看复制到剪切板打印

<table>   
<tr><th>Value</th>   
    <th>Square</th></tr>   
<c:forEach var="x" begin="0" end="10" step="2">   
  <tr><td><c:out value="${x}"/></td>   
      <td><c:out value="${x * x}"/></td></tr>   
</c:forEach>   
</table>  

<table>
<tr><th>Value</th>
    <th>Square</th></tr>
<c:forEach var="x" begin="0" end="10" step="2">
  <tr><td><c:out value="${x}"/></td>
      <td><c:out value="${x * x}"/></td></tr>
</c:forEach>
</table>

如图 3 中所示，上面的示例代码生成了一张表，显示前五个偶数及其平方。这是通过将 begin 和 step 属性值指定为 2，而将 end 属性值指定为 10 实现的。此外，用 var 属性创建用于存储索引值的限定了作用域的变量， <c:forEach> 标记体内引用了该变量。尤其是，使用了一对 <c:out> 操作来显示索引及其平方，其中索引的平方是使用一个简单的表达式计算得来的。


图 3. 清单 2 的输出


在对集合的成员进行迭代时，用到了 <c:forEach> 标记的另一个属性： items 属性，清单 3 中显示了该属性。当使用这种形式的 <c:forEach> 标记时， items 属性是唯一必需的属性。 items 属性的值应该是一个集合，对该集合的成员进行迭代，通常使用 EL 表达式指定值。如果变量名称是通过 <c:forEach> 标记的 item 属性指定的，那么对于每次迭代该已命名变量都将被绑定到集合后续元素上。


清单 3. 通过 <c:forEach> 操作对集合进行迭代的语法
查看复制到剪切板打印

<c:forEach var="   
        name" items="  
        expression" varStatus="  
        name"   
    begin="   
        expression" end="  
        expression" step="  
        expression">   
     
        body content   
</c:forEach>  

<c:forEach var="
        name" items="
        expression" varStatus="
        name"
    begin="
        expression" end="
        expression" step="
        expression">
  
        body content
</c:forEach>

<c:forEach> 标记支持 Java 平台所提供的所有标准集合类型。此外，您可以使用该操作来迭代数组（包括基本类型数组）中的元素。表 1 列出了 items 属性所支持的所有值。正如表的最后一行所指出的那样，JSTL 定义了它自己的接口 javax.servlet.jsp.jstl.sql.Result ，用来迭代 SQL 查询的结果。（我们将在本系列后面的文章中详细讨论这一功能。）

表 1. <c:forEach> 标记的 items 属性所支持的集合
items 的值  所产生的 item 值 
java.util.Collection  调用 iterator() 所获得的元素 
java.util.Map  java.util.Map.Entry 的实例 
java.util.Iterator  迭代器元素
java.util.Enumeration  枚举元素
Object 实例数组  数组元素
基本类型值数组 经过包装的数组元素
用逗号定界的 String  子字符串
javax.servlet.jsp.jstl.sql.Result  SQL 查询所获得的行


可以使用 begin 、 end 和 step 属性来限定在迭代中包含集合中哪些元素。和通过 <c:forEach> 进行数字迭代的情形一样，在迭代集合中的元素时同样要维护一个迭代索引。 <c:forEach> 标记实际上只处理那些与索引值相对应的元素，这些索引值与指定的 begin 、 end 和 step 值相匹配。

清单 4 显示了用来迭代集合的 <c:forEach> 标记。对于该 JSP 代码段， entryList 这一限定了作用域的变量被设置成了 Entry 对象列表（确切的说， ArrayList ）。 <c:forEach> 标记依次处理列表中的每个元素，将其赋给一个限定了作用域的变量 blogEntry ，然后生成两个表行 ― 一个用于 Weblog 项的 title ，另一个则用于该项 text 。这些特性是通过一对带有相应 EL 表达式的 <c:out> 操作从 blogEntry 变量检索得到的。注：由于 Weblog 项的标题和文本都可能包含 HTML 标记，因此这两个 <c:out> 标记的 escapeXml 属性都被设置成了 false。图 4 显示了结果。


清单 4. 使用 <c:forEach> 标记显示表示给定日期的 Weblog 项
查看复制到剪切板打印

<table>   
  <c:forEach items="${entryList}" var="blogEntry">   
    <tr><td align="left" class="blogTitle">   
      <c:out value="${blogEntry.title}" escapeXml="false"/>   
    </td></tr>   
    <tr><td align="left" class="blogText">   
      <c:out value="${blogEntry.text}" escapeXml="false"/>   
    </td></tr>   
  </c:forEach>   
</table>  

<table>
  <c:forEach items="${entryList}" var="blogEntry">
    <tr><td align="left" class="blogTitle">
      <c:out value="${blogEntry.title}" escapeXml="false"/>
    </td></tr>
    <tr><td align="left" class="blogText">
      <c:out value="${blogEntry.text}" escapeXml="false"/>
    </td></tr>
  </c:forEach>
</table>

图 4. 清单 4 的输出


不论是对整数还是对集合进行迭代， <c:forEach> 剩余的属性 varStatus 所起的作用相同。和 var 属性一样， varStatus 用于创建限定了作用域的变量。不过，由 varStatus 属性命名的变量并不存储当前索引值或当前元素，而是赋予 javax.servlet.jsp.jstl.core.LoopTagStatus 类的实例。该类定义了一组特性，它们描述了迭代的当前状态，表 2 中列出了这些特性。

表 2. LoopTagStatus 对象的特性
特性  Getter  描述 
current getCurrent()  当前这次迭代的（集合中的）项
index getIndex()  当前这次迭代从 0 开始的迭代索引
count getCount()  当前这次迭代从 1 开始的迭代计数
first isFirst()  用来表明当前这轮迭代是否为第一次迭代的标志
last isLast()  用来表明当前这轮迭代是否为最后一次迭代的标志
begin getBegin()  begin 属性值 
end getEnd()  end 属性值 
step getStep()  step 属性值 




清单 5 显示了关于如何使用 varStatus 属性的一个示例。这个示例修改了清单 4 中的代码，将 Weblog 项的编号添加到显示 Weblog 标题（title）的表行。它是通过为 varStatus 属性指定一个值，然后访问所生成的限定了作用域的变量的 count 特性来实现这一点的。结果显示在图 5 中。


清单 5. 使用 varStatus 属性来显示 Weblog 项的数目
查看复制到剪切板打印

<table>   
  <c:forEach items=   
    "${entryList}" var="blogEntry" varStatus="status">   
    <tr><td align="left" class="blogTitle">   
      <c:out value="${status.count}"/>.   
      <c:out value="${blogEntry.title}" escapeXml="false"/>   
    </td></tr>   
    <tr><td align="left" class="blogText">   
      <c:out value="${blogEntry.text}" escapeXml="false"/>   
    </td></tr>   
  </c:forEach>   
</table>  

<table>
  <c:forEach items=
    "${entryList}" var="blogEntry" varStatus="status">
    <tr><td align="left" class="blogTitle">
      <c:out value="${status.count}"/>.
      <c:out value="${blogEntry.title}" escapeXml="false"/>
    </td></tr>
    <tr><td align="left" class="blogText">
      <c:out value="${blogEntry.text}" escapeXml="false"/>
    </td></tr>
  </c:forEach>
</table>

图 5. 清单 5 的输出


除 <c:forEach> 以外， core 库还提供了另一个迭代标记： <c:forTokens> 。JSTL 的这个定制操作与 Java 语言的 StringTokenizer 类的作用相似。清单 6 中显示的 <c:forTokens> 标记除了比 <c:forEach> 的面向集合版本多一个属性之外，其它属性都相同。对于 <c:forTokens> 而言，通过 items 属性指定要标记化的字符串，而通过 delims 属性提供用于生成标记的一组定界符。和 <c:forEach> 的情形一样，可以使用 begin 、 end 和 step 属性将要处理的标记限定为那些与相应索引值相匹配的标记。


清单 6. 使用 <c:forTokens> 操作来迭代字符串标记的语法
查看复制到剪切板打印

<c:forTokens var="   
        name" items="  
        expression"   
    delims="   
        expression" varStatus="  
        name"   
    begin="   
        expression" end="  
        expression" step="  
        expression">   
     
        body content   
</c:forTokens>  

<c:forTokens var="
        name" items="
        expression"
    delims="
        expression" varStatus="
        name"
    begin="
        expression" end="
        expression" step="
        expression">
  
        body content
</c:forTokens>