首页 > 代码库 > JSTL标签库的使用语法
JSTL标签库的使用语法
在JSP的开发中，迭代是经常要使用到的操作。例如，逐行的显示查询的结果等。在早期的JSP中，通常使用Scriptlets来实现Iterator或者Enumeration对象的迭代输出。现在，通过JSTL的迭代标签可以在很大的程度上简化迭代操作。
JSTL所支持的迭代标签有两个，分别是<c:forEach>和<c:forTokens>。在这里介绍的是<c:forEach>标签。
简单点说，<c:forEach>标签的作用就是迭代输出标签内部的内容。它既可以进行固定次数的迭代输出，也可以依据集合中对象的个数来决定迭代的次数。
<c:forEach>标签的语法定义如下所示。
<c:forEach var="name" items="expression" varStatus="name"
begin="expression" end="expression" step="expression">
body content
</c:forEach>
<c:forEach>标签具有以下一些属性：
var：迭代参数的名称。在迭代体中可以使用的变量的名称，用来表示每一个迭代变量。类型为String。
items：要进行迭代的集合。对于它所支持的类型将在下面进行讲解。
varStatus：迭代变量的名称，用来表示迭代的状态，可以访问到迭代自身的信息。
begin：如果指定了items，那么迭代就从items[begin]开始进行迭代；如果没有指定items，那么就从begin开始迭代。它的类型为整数。
end：如果指定了items，那么就在items[end]结束迭代；如果没有指定items，那么就在end结束迭代。它的类型也为整数。
step：迭代的步长。
<c:forEach>标签的items属性支持Java平台所提供的所有标准集合类型。此外，您可以使用该操作来迭代数组（包括基本类型数组）中的元素。它所支持的集合类型以及迭代的元素如下所示：
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查询所获得的行。
不论是对整数还是对集合进行迭代，<c:forEach>的varStatus属性所起的作用相同。和var属性一样，varStatus用于创建限定了作用域的变量（改变量只在当前标签体内起作用）。不过，由varStatus属性命名的变量并不存储当前索引值或当前元素，而是赋予javax.servlet.jsp.jstl.core.LoopTagStatus类的实例。该类包含了一系列的特性，它们描述了迭代的当前状态，如下这些属性的含义如下所示：
current：当前这次迭代的（集合中的）项。
index：当前这次迭代从0开始的迭代索引。
count：当前这次迭代从1开始的迭代计数。
first：用来表明当前这轮迭代是否为第一次迭代，该属性为boolean类型。
last：用来表明当前这轮迭代是否为最后一次迭代，该属性为boolean类型。
begin：begin属性的值。
end：end属性的值
step：step属性的值
下面就来看一个个基本的例子，表格隔行背景色变化
<c:forEach var="item" items="${contents}" varStatus="status">
<tr <c:if test="${status.count%2==0}">bgcolor="#CCCCFE"</c:if> align="left">
xxx
</tr>
</c:forEach>
JSTL是一个标准的已
制定好的标签库，可以应用于各种领域，如:基本输入输出，流程控制，循环，XML文件剖析，数据库查
询以及国际化和文字格式标准化的应用等。JSTL所提供的标签库分为以下五大类:
核心标签库(Core tag Liabry)主要有:基本输入输出，流程控制，迭代操作和URL操作。
在JSP中使用JSTL中的标签库时，必须使用<%@taglib%>指令，并且设定prefix和uri的值得，通常设定:
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
这样就可以使用核心标签库了。
.表达式操作
表达式操作分类中包含四个标签: <c:out>,<c:set>,<c:remove>和<c:catch>
<c:out>：重要用来显示数据的内容，类似与<%=scripting-language%>。它的语法如下:
语法1: 没有body内容
<c:out http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/value="value" [escapeXml="{true|false}"] [default="defaultValue"]/>
语法2: 有body内容
<c:out http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/value="value" [escapeXml="{true|false}"]>
default value
</c:out>
Attribute
-----------------------------------------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
value 需要显示的值 Y Object 是 无
default 如果value值为null,则显示default的值 Y Object 否 无
escapeXml 是否转换特殊字符，如: <转换为&It Y Object 否 true
----------------------------------------------------------------------------------------------------------------------
Null和错误说明
假若value为null,会显示default的值；假若没有设定default的值，则会显示一个空的字符串。
<c:set>:主要用来把变量存储至JSP范围或是JavaBean的属性中。
语法1: 没有body
将value的值存储至范围为scope的varName变量之中
<c:set http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/value="value" var="varName" [scope="{page|request|session|application}"]/>
语法2: 有body
将body内容存储至范围为scope的varName变量之中
<c:set http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/value="value" [scope="{page|request|session|application}"]>
body.....
</c:set>
语法3: 将value的值存储至target对象属性中
<c:set http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/http://www.mamicode.com/value="value" target="target" property="propertyNmae"/>
语法4: 将body内容的数据存储至target对象属性中
<c:set target="target" property="propertyNmae">
body....
</c:set>
Attribute
----------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
value 要被存储的值 Y Object 否 无
var 欲存入的变量名 N String 否 无
scope var变量的JSP范围 N String 否 page
target 为一JavaBean或java.util.Map对象 Y Object 否 无
property 指定target对象属性 Y String 否 无
------------------------------------------------------------------------------------------
Null 和 错误处理:
语法3和语法4会产生异常错误,有以下两种情况:
.target 为null
.target 不是java.util.Map或JavaBean对象
假若value为null时:将由存储变量改为移除变量
.语法1: 由var和scope所定义的变量，将被移除
.若scope已指定时，则PageContext.removeAttribute(varName,scope);
.若scope未指定时，则PageContext.removeAttribute(varName);
.语法3:
.假若target为Map时，则Map.remove(property);
.假若target为JavaBean时，propertye指定的属性为null
注意: var和scope这两个属性不能使用表达式来表示，我们不能写成 scope="${ourScope}"或var="${a}"
<c:remove>:主要用来移除变量。
语法:
<c:remove var="varName" [scope="{page|request|session|application}"]/>
Attribute
----------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
var 欲移除变量的名称 N String 是 无
scope var变量的JSP范围 N String 否 page
----------------------------------------------------------------------------------------
说明:
<c:remove>必须要有var属性，即要被移除的属性名称，scope则可有可无，如:
<c:remove var="username" scope="session"/>
将username变量从session范围移除。若我们不设定scope，则<c:remove>会移除所有范围名称为username
的数据。
<c:catch>:主要用来处理产生错误的异常情况，并且将信息保存起来。
语法:
<c:catch [var="varName"]>
...欲抓取错误的部分...
</c:catch>
Attribute
----------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
var 用来存储错误信息的变量 N String 否 无
-----------------------------------------------------------------------------------------
说明:
<c:catch>主要将可能发生错误的部分放在<c:catch>和</c:catch>之间。如果真的发生错误，可将错误
信息保存至变量varName标量中，如:
<c:catch var="message">
//可能发生错误的部分
</catch>
另外，当错误发生<c:catch>和</c:catch>之间时，只有<c:catch>和</c:catch>之间的程序会被中止忽
略，但整个网页不会被中止。
流程控制
流程控制分类中包含四个标签:<c:if>,<c:choose>,<c:when>和<c:otherwise>。
<c:if>:的用途和我们在一般程序中写的if一样。
语法:
语法1：没有body
<c:if test="testCondition" var="varName" [scope="{page|request|session|application}"]/>
语法2: 有body
<c:if test="testCondition" [var="varName"] [scope="{page|request|session|appliation}"]>
...body....
</c:if>
Attribute
------------------------------------------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
test 如果表达式的结果为true则执行body,false则相反 Y boolean 是 无
var 用来存储test运算后的结果，即true或false N String 否 无
scope var变量的JSP范围 N String 否 page
------------------------------------------------------------------------------------------------------------------------
说明:
<c:if>标签必须要有test属性，body里除了能是静态文本之外可以是任何JSP代码，标签或HTML代码。
<c:choose>:本身只当作<c:when>和<c:otherwise>的父标签。
语法:
<c:choose>
body(<when>和<otherwise>)
</c:choose>
限制:
<c:choose>的本地内容只能有:
.空白
.1或多个<c:when>
.0或多个<c:otherwise>
如:
<c:choose>
<c:when test="${condition1}">
condition1 为 true
</c:when>
<c:when test="${condition2}">
condition2 为 true
</c:when>
<c:otherwise>
condition1和conditon2都为false
</<c:otherwise >
</c:choose>
说明:
在同一个<c:choose>中，假如所有的<c:when>的test都不为true时，则执行<c:otherwise>的本体内容。
在同一个<c:choose>中，假若有好几个<c:when>都会true时，只能有一个<c:when>成立。
迭代操作
迭代(Iterator)操作主要包含两个标签: <c:forEach>和<c:forTokens>。
<c:forEach>为循环控制，它可以将集合(Collection)中的成员循序浏览一遍。运做方式为当条件符合
时，就会持续重复执行<c:forEach>的body内容。
语法:
语法1: 迭代一集合对象之所有成员
<c:forEach [var="varName"] items="collection" [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]>
...body内容.....
<c:forEach>
语法2: 迭代指定的次数
<c:forEach [var="varName"] [varStatus="varStatusName"]
begin="begin" end="end" [step="step"]>
...body内容.....
<c:forEach>
Attribute
--------------------------------------------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
var 用来存放现在指到的成员 N String 否 无 items 被迭代的集合对象 Y Iterator 否 无
varStatus 用来存放到指到的相关成员信息 N String 否 无
begin 开始的位置 Y int 否 0
end 结束的位置 Y int 否 最后一个成员
setp 每次迭代的间隔数 Y int 否 1
-------------------------------------------------------------------------------------------------------------------------
Null 和 错误处理
.假若items为null时，则表示为一空的集合对象
.假若begin大于或等于items时，则迭代不运算
注意:
varName的范围只存在<c:forEach>的本体中，如果超出了本题，则不能取得varName的值。如:
<c:forEach items="${atts}" var="item">
</c:forEach>
${item}</br>
${item}则不会显示item的内容。<c:forEach>除了支持数组之外，还有标准的J2SE的结合类型，例如:
ArrayList,List,LinkedList,Vector,Stack和Set等等；另外包括java.util.Map类的对象，例如:
HashMap,Hashtable,Properties,Provider和Attributes。
另外<c:forEach>还提供了varStatus属性，主要用来存放现在指到成员的相关信息。例如：我们写成
varStatus="s",那么就会把信息存放到名称为s的属性当中。varStatus属性还提供另外四个属性:index,
count,fist和last，它们个自的意义如下:
------------------------------------------------------------------------------------------
属性 类型 意义
index number 现在指到成员的索引
count number 总共指到成员的总和
first boolean 现在指到成员是否为第一个
last boolean 现在指到成员是否为最后一个
-------------------------------------------------------------------------------------------
如下例子:
<%@page contentType="text/html;charset=gb2312"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%
String atts[] = new String[5];
atts[0]="hello";
atts[1]="this";
atts[2]="is";
atts[3]="a";
atts[4]="girl";
request.setAttritue("atts",atts);
%>
<c:forEach items="${atts}" var="item" varStatus="s">
<h2><c:out value="http://www.mamicode.com/${item}"/>的四种属性></h2>
index: ${s.index}</br>
count: ${s.count}</br>
first: ${s.first}</br>
last: ${s.last}</br>
</c:forEach>
<c:forTokens>
<c:forTokens>:用来浏览一字符串中所有的成员，起成员是由定义符号(delimiters)所分隔的。
语法:
<c:forTokens items="stringFoTokens" delims="delimmmmiters" [var="varName"]
[varStatus="varStatusName"] [begin="begin"] [end="end"] [step="step"]>
...body内容....
</c:forTokens>
Attribute
--------------------------------------------------------------------------------------------------------------------
名称 说明 EL 类型 必须 默认值
var 用来存放现在指到的成员 Y String 否 无
items 被迭代的字符串 Y String 是 无
delims 定义用来分割字符串的字符 N String 是 无
varStatus 用来存放现在指到的相关成员信息 N String 否 无
begin 开始的位置 Y int 否 0
end 结束的位置 Y int 否 最后一个成员
step 每次迭代间隔数 Y int 否 1
---------------------------------------------------------------------------------------------------------------------
限制:
.假若有begin属性时，begin必须大于等于0
.假若有end属性时，必须大于begin
.假若有step属性时，step必须大于等于1
Null 和 错误处理
.假如itmes为null时,则表示为有空的集合对象
.假若begin大于等于items的大小时，则迭代不运算
例子:
<c:forToken items="A,B,C,D,E,F,G" delims="," var="item>
${item}
</c:forToken>
items属性也可以用EL，例如:
<%
String phonenumber="123-456-7899";
request.setAttribute("userPhone",phonenumber);
%>
<c:forTokens items="${userPhone}" delims="-" var="item">
${item}
</c:forTokens>
URL操作
JSTL包含三个URL操作有关的标签,分别是: <c:import>,<c:redirect>和<c:url>。它们的主要功能是：
用来将其他文件的内容包含起来，网页的向导，还有url的产生。
本文出自 “華麗Dē‖Java Question” 博客，请务必保留此出处http://teny32.blog.51cto.com/8027509/1853700
JSTL标签库的使用语法