首页 > 代码库 > 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标签库的使用语法