JSTL 全名为Java Server Pages Standard Tag Library(JSP Standard Tag Library),它的中文名称为JSP 标准标签函数库。Web 程序开发人员能够利用JSTL和EL来开发Web 程序,取代传统直接在页面上嵌入Java程序(Scripting)的做法,以提高程序可读性、维护性和方便性。
JSTL是一个标准的已制定好的标签库,可以应用于各种领域,如:基本输入输出、流程控制、循环、XML文件剖析、数据库查询及国际化和文字格式标准化的应用等。JSTL所提供的标签函数库主要分为五大类:
(1)核心标签库 (Core tag library)
(2)I18N 格式化标签库 (I18N-capable formatting tag library)
(3)SQL 标签库 (SQL tag library)
(4)XML 标签库 (XML tag library)
(5)函数标签库 (Functions tag library)
JSTL 前缀 URI
核心标签库 c http://java.sun.com/jsp/jstl/core
I18N格式化标签库 fmt http://java.sun.com/jsp/jstl/fmt
SQL标签库 sql http://java.sun.com/jsp/jstl/sql
XML标签库 xml http://java.sun.com/jsp/jstl/xml
函数标签库 fn http://java.sun.com/jsp/jstl/functions
若要在JSP 网页中使用JSTL,一定要先做下面这行声明:
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
核心标签库 (Core tag library)
Core 标签库,又被称为核心标签库,该标签库的工作是对于 JSP 页面一般处理的封装。在该标签库中的标签一共有 14 个,被分为了四类,分别是:
通用核心标签: <c:out> 、 <c:set> 、 <c:remove> 、 <c:catch> 。
条件控制标签: <c:if> 、 <c:choose> 、 <c:when> 、 <c:otherwise> 。
循环控制标签: <c:forEach> 、 <c:forTokens> 。
URL 相关标签: <c:import> 、 <c:url> 、 <c:redirect> 、 <c:param> 。
一、通用核心标签:<c:out>, <c:set>, <c:remove>, <c:catch>
1.<c:out>
<c:out>主要用来显示数据的内容,就像是 <%= scripting-language %> 一样,例如:Hello ! <c:out value="${username}" />。
语法1:没有Body的情况
<c:out value="value" [escapeXml="{true|false}"] [default="defaultValue"]/>
语法2:有Body的情况
<c:out value="value" [excapeXml="{true|false}"]
default value
</c:out>
属性名称 说明 EL类型 必须 默认值
value 需要显示出来的值 Y Object 是 无
default 如果value的值为null则显示default的值 Y Object 否 无
escapeXml 是否转换特殊字符,如:<转换成< Y boolean 否 true
default Object 如果value是null,那么输出这个default值。
注意:
表格中的EL字段,表示此属性的值是否可以为EL表达式,例如:Y表示attribute="${表达式}"为符合语法的,N 则反之。
Null 和错误处理:
假若 value为null,会显示default 的值;假若没有设定default的值,则会显示一个空的字符串。
说明:
一般来说,<c:out>默认会将 <、>、’、” 和 & 转换为 <、>、'、" 和 &。
假若不想转换时,只需要设定<c:out>的escapeXml 属性为fasle 就可以了。
范例1、<c:out value="Hello JSP 2.0 !! " /> 在网页上显示 Hello JSP 2.0 !! ;
范例2、<c:out value="${ 3 + 5 }" /> 在网页上显示 8;
范例3、<c:out value="${ param.data }" default="No Data" /> 在网页上显示由窗体传送过来的data 参数之值,假若没有data 参数,或data 参数的值为null 时,则网页上会显示No Data;
范例4、<c:out value="<p>有特殊字符</p>" /> 在网页上显示“<p>有特殊字符</p>”;
范例5、<c:out value="<p>有特殊字符</p>" escapeXml="false" /> 在网页上显示“有特殊字符”。
2.<c:set>
<c:set>主要用来将变量储存至JSP范围(Request, Session, Application等)中或是JavaBean的属性中(设置某个对象的属性)。
语法1.使用value属性设置一个特定范围中的属性.
<c:set value="value" var="varName" [scope="{page|request|session|application}"]/>
语法2.使用value属性设置一个特定范围中的属性,并且带有一个Body.
<c:set var="varName" [scope="{page|request|session|application}"]>
body content
</c:set>
语法3.设置某个特定对象的一个属性.
<c:set value="value" target="target" property="propertyName"/>
语法4.设置某个特定对象的一个属性,并且带有一个Body
<c:set target="target" property="propertyName"/>
body content
</c:set>
属性名称 说明 EL类型 必须 默认值
value 要被储存的值 Y Object 否 无
var 欲存入的变量名称 N String 否 无
scopevar 变量的JSP范围 N String 否 page
target 为一JavaBean或java.util.Map对象 Y Object 否 无
property 指定target对象的属性 Y String 否 无
范例:
范例1、<c:set var="number" scope="request" value="${1 + 1}" /> 将2 存入Request 范围的number 变量中;
范例2、<c:set var="number" scope="session" />
${3 + 5}
</c:set> 将8 存入Session 范围的number 变量中;<c:set>是把本体(body)运算后的结果来当做value的值。
范例3、<c:set var="number" scope="request" value="${ param.number }" /> 假若 ${param.number}为null 时,则移除Request 范围的number 变量;若${param.number}不为null 时,则将 ${param.number}的值存入Request 范围的number 变量中;
范例4、<c:set target="User" property="name" value="${ param.Username}" /> 假若 ${param.Username}为null 时,则设定User(JavaBean)的name 属性为null;若不为
null 时,则将 ${param.Username}的值存入User(JavaBean)的name 属性(setter 机制)。
注意:
上述范例的3.中,假若 ${param.number}为null时,则表示移除Request范围的number变量。
3.<c:remove>
<c:remove>主要用来移除变量。
语法:
<c:remove var="varname" [scope="{page|request|session|application}"]/>
属性名称 说明 EL类型 必须 默认值
var 欲移除的变量名称 N String 是 无
scope var 变量的JSP范围 N String 否 page
说明:
<c:remove>必须要有var 属性,即要被移除的属性名称,scope 则可有可无,例如:
<c:remove var="number" scope="session" />
将number 变量从Session 范围中移除。若我们不设定scope,则<c:remove>将会从Page、Request、Session 及Application 中顺序寻找是否存在名称为number 的数据,若能找到时,则将它移除掉,反之则不会做任何的事情。
4.<c:catch>
<c:catch>主要用来处理产生错误的异常状况,并且将错误信息储存起来。
语法:
<c:catch [var="varName"]>
nested actions
</c:catch>
属性名称 说明 EL类型 必须 默认值
var 用来储存错误信息的变量 N String 否 无
说明:
<c:catch>主要将可能发生错误的部分放在<c:catch>和</c:catch>之间。如果真的发生错误,可以将错误信息储存至varName 变量中,例如:
<c:catch var="message">
: //可能发生错误的部分
</c:catch>
另外,当错误发生在<c:catch>和</c:catch>之间时,则只有<c:catch>和</c:catch>之间的程序会被中止忽略,但整个网页不会被中止。
二、条件标签:<c:if>, <c:choose>, <c:when>, <c:otherwise>
1.<c:if>
<c:if>的用途就和我们一般在程序中用的if 一样。
语法1.
<c:if test="testCondition" var="varName" [scope="{page|request|session|application}"]/>
语法2.
<c:if test="testCondition" [value="varName"] [scope="{page|request|session|application}"]>
body content
</c:if>
属性说明:
属性名称 说明 EL类型 必须 默认值
Test 表达式结果为true,执行本体内容,false相反 Y boolean 是 无
var 用来储存test运算后的结果,即true或false N String 否 无
scope var变量的JSP范围 N String 否 page
2.<c:choose>
<c:choose>本身只当做 <c:when> 和 <c:otherwise> 的父标签。
语法
<c:choose>
body content(<when> and <otherwise> subtags)
</c:choose>
注意,它的body content只能由以下的元素构成:
(1) 空格
(2) 0个或多个<when>,<when>必须在,<otherwise>之前出现
(3) 0个或一个<otherise>
说明:
若使用<c:when>和<c:otherwise>来做流程控制时,两者都必须为<c:choose>的子标签.
3.<c:when>
<c:when>的用途就和我们一般在程序中用的when 一样。
语法:
<c:when test="testCondition">
body content
</c:when>
属性名称 说明 EL类型 必须 默认值
Test 表达式结果为true,执行本体内容,false相反 Y boolean 是 无
限制:
a、 <c:when>必须在<c:choose>和</c:choose>之间
b、 在同一个<c:choose>中时,<c:when>必须在<c:otherwise>之前
说明
<c:when>必须有test 属性,当test中的表达式结果为true时,则会执行本体内容;如果为false时,则不会执行
有两个限制:
(1)必须以<c:choose>作为它的父标签
(2)必须在<c:otherwise>之前出现
4.<c:otherwise>
在同一个 <c:choose> 中,当所有 <c:when> 的条件都没有成立时,则执行<c:otherwise> 的本体内容。
语法:
<c:otherwise>
本体内容
</c:otherwise>
三、迭代标签:<c:forEach>,<c:forTokens>
1.<c:forEach>
<c:forEach> 为循环控制,它可以将集合(Collection)中的成员循序浏览一遍。运作方式为当条件符合时,就会持续重复执行<c:forEach>的本体内容。
语法1:在Collection中迭代
<c:forEach [var="varName"] items="collection"
[varStatus="varStatusName"] [begin="begin"][end="end"][step="step"]>
本体内容
</c:forEach>
语法2:迭代固定的次数
<c:forEach [var="varName"] [varStatus="varStausName"]
begin="begin" end="end" [step="step"]>
本体内容
</c:forEach>
属性说明:
var String 迭代参数的变量名
items 支持的类型 将要迭代的集合
varStatus String 表示迭代的状态,可以访问迭代自身的信息
begin int 开始索引
end int 结束索引
step int 迭代的步长
限制:
a、假若有begin 属性时,begin 必须大于等于 0
b、假若有end 属性时,必须大于begin
c、假若有step 属性时,step 必须大于等于0
Null 和错误处理:
a、假若items 为null 时,则表示为一空的集合对象
b、假若begin 大于或等于items 时,则迭代不运算
如下示例:
<%@ page contentType="text/html;charset=GB2312 " %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
<title>CH7 - Core_forEach.jsp</title>
</head>
<body>
<h2><c:out value="<c:forEach> 的用法" /></h2>
<%
String atts[] = new String [5];
atts[0]="hello";
atts[1]="this";
atts[2]="is";
atts[3]="a";
atts[4]="pen";
request.setAttribute("atts", atts);
%>
<c:forEach items="${atts}" var="item" >
${item}</br>
</c:forEach>
</body>
</html>
<c:forEach>除了支持数组之外,还有标准J2SE 的集合类型,例如:ArrayList、List、LinkedList、Vector、Stack和Set 等等;另外还包括java.util.Map 类的对象.
<c:forEach>并不只是用来浏览集合对象而已,读者可以从语法2中发现,items并不存在,但是当没有使用items 属性时,就一定要使用begin 和end 这两个属性。
<%@ page contentType="text/html;charset=GB2312" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
<title>CH7 - Core_forEach2.jsp</title>
</head>
<body>
<h2><c:out value="<c:forEach> 循环" /></h2>
<c:forEach begin="1" end="10" var="item" >
${item}</br>
</c:forEach>
</body>
</html>
上述范例中,我们并没有执行浏览集合对象,只是设定begin 和end 属性的值,这样它就变成一个普通的循环。此范例是将循环设定为:从1 开始跑到10,总共会重复循环10 次,并且将数字放到item 的属性当中。
另外,<c:forEach>还提供varStatus 属性,主要用来存放现在指到之成员的相关信息。例如: varStatus="s",那么将会把信息存放在名称为s的属性当中。varStatus属性还有另外四个属性:index、count、first 和last,它们各自代表的意义如表:
属性 类型 意义
index number 现在指到成员的索引
count number 总共已经指到成员的总数
first boolean 现在指到的成员是否为第一个成员
last boolean 现在指到的成员是否为最后一个成员
我们可以使用varStatus 属性取得循环正在浏览之成员的信息,下面为一个简单的范例:
<%@ page contentType="text/html;charset=GB2312" %>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<html>
<head>
</head>
<body>
<h2><c:out value="<c:forEach> varStatus 的四种属性" /></h2>
<%
String atts[] = new String [5];
atts[0]="hello";
atts[1]="this";
atts[2]="is";
atts[3]="a";
atts[4]="pen";
request.setAttribute("atts", atts);
%>
<c:forEach items="${atts}" var="item"varStatus="s">
<h2><c:out value="${item}"/>的四种属性:</h2>
index:${s.index}</br>
count:${s.count}</br>
first:${s.first}</br>
last:${s.last}</br>
</c:forEach>
</body>
</html>
2.<c:forTokens>
<c:forTokens> 用来浏览一字符串中所有的成员,其成员是由定义符号(delimiters)所分隔的。
语法:
<c:forTokens items="stringOfTokens" delims="delimiters"
[var="varName"] [varStatus="varStatusName"]
[begin="begin"] [end="end"] [step="step"]>
body content
</c:forTokens>
属性说明:
var String 迭代的参数名
items String 将要迭代的String
varStatus String 表示迭代的状态,可以访问迭代自身的信息
delims String 分隔符
begin int 开始索引
end int 结束索引
step int 迭代的步长
说明:
<c:forTokens>的begin、end、step、var 和varStatus 用法都和<c:forEach>一样,因此,笔者在这里就只介绍items 和delims 两个属性:items 的内容必须为字符串;而delims 是用来分割items 中定义的字符串之字符。
范例:
下面为一个典型的<c:forTokens>的范例:
<c:forTokens items="A,B,C,D,E" delims="," var="item" >
${item}
</c:forTokens>
上面范例执行后,将会在网页中输出ABCDE。它会把符号“,”当做分割的标记,拆成5 个部分,也就是执行循环5 次,但是并没有将A,B,C,D,E 中的“,”显示出来。items 也可以放入EL 的表达式,如下:
<%
String phoneNumber = "123-456-7899";
request.setAttribute("userPhone", phoneNumber);
%>
<c:forTokens items="${userPhone}" delims="-" var="item" >
${item}
</c:forTokens>
这个范例将会在网页上打印1234567899,也就是把123-456-7899以“-”当做分割标记,将字符串拆为3 份,每执行一次循环就将浏览的部分放到名称为item 的属性当中。delims 不只指定一种字符来分割字符串,它还可以一次设定多个分割字符串用的字符。如下面这个范例:
<c:forTokens items="A,B;C-D,E" delims=",;-" var="item" >
${item}
</c:forTokens>
此范例会在网页输出ABCDE,也就是说,delims 可以一次设定所有想当做分割字符串用的字符。其实用 <c:forEach>也能做到分割字符串,写法如下:
<c:forEach items="A,B,C,D,E" var="item" >
${item}
</c:forEach>
上述范例同样也会在网页输出ABCDE。<c:forEach>并没有delims这个属性,因此<c:forEach>无法设定分割字符串用的字符,而<c:forEach>分割字符串用的字符只有“,”,这和使用<c:forTokens>,delims 属性设为“,”的结果相同。所以如果使用<c:forTokens>来分割字符串,功能和弹性上会比使用<c:forEach>来得较大。
四、URL相关的标签<c:import>,<c:redirect>,<c:url>,<c:param>
1.<c:import>
导入一个基于URL的资源。
语法1:
<c:import url="url" [context="context"] [var="varName"]
[scope="{page|request|session|application}"]
[charEncoding="charEncoding"]>
optional body content for <c:param> subtags
</c:import>
语法2:
<c:import="url" [context="context"] varReader="varReaderName"
[charEncoding="charEncoding"]>
body content where varReader is consumed by another action
</c:import>
属性说明:
url String 待导入资源的URL
context String 当使用相对路径访问外部context资源时,context指定了这个资源的名字
var String 参数的名称
scope String var参数的作用范围
charEncoding String 输入资源的字符编码
varReader String 这个参数的类型是Reader,用于读取资源
2.<c:redirect>
把客户的请求重定向到另一个资源。
语法1.
<c:redirect url="value" [context="context"]/>
语法2.
<c:redirect url="value" [context="context"]>
<c:param>subtags
</c:redirect>
属性说明:
url String 待定向资源的URL
context String 当使用相对路径访问外部context资源时,context指定的这个资源的名字.
3.<c:url>
用于构造URL,主要的用途是URL重写
语法1.
<c:url value="value" [context="context"]
[var="varName"] [scope="{page|request|session|application}"]/>
语法2.
<c:url value="value" [context="context"]
[var="varName"] [scope="{page|request|session|application}"]>
<c:param>subtags
</c:url>
4.<c:param>
在<c:import>, <c:url>,<c:redirect>中添加请求的参数
语法1.
<c:param name="name" value="value"/>
语法2.
<c:param name="name">
paramter value
</c:param>