JavaWind >> Java document >> JSTL EL 详解

JSTL EL 详解

EL 表达式

概述：
      在JSP页面中，使用标签库代替传统的Java片段语言来实现页面的显示逻辑已经不是新技术了，然而，由自定义标签很容易造成重复定义和非标准的实现。鉴于此，出现了JSTL（JSP Standard Tag Library），为大多数JSP页面逻辑提供了实现的JSTL技术，该技术本身就是一个标签库。
      Sun公司Java规范标准的JSTL由apache jakarta组织负责维护。作为开源的标准技术，它一直在不断地完善。JSTL的发布包有两个版本：Standard-1.0 Taglib、Standard-1.1 Taglib，它们在使用时是不同的。
      Standard-1.0 Taglib（JSTL1.0）支持Servlet2.3和JSP1.2规范，Web应用服务器Tomcat4支持这些规范，而它的发布也在Tomcat 4.1.24测试通过了。
      Standard-1.1 Taglib（JSTL1.1）支持Servlet2.4和JSP2.0规范，Web应用服务器Tomcat5支持这些规范，它的发布在Tomcat 5.0.3测试通过了。
      在本章的介绍中，将以由Sun发布的Standard-1.1 Taglib标签库为主，而apache jakarta组织发布的开源标签库，可以从http://jakarta.apache.org/taglibs/找到所需要的帮助。Sun发布的标准JSTL1.1标签库有以下几个标签：
      核心标签库：包含Web应用的常见工作，比如：循环、表达式赋值、基本输入输出等。
      国际化标签库：用来格式化显示数据的工作，比如：对不同区域的日期格式化等。
      数据库标签库：可以做访问数据库的工作。
      XML标签库：用来访问XML文件的工作，这是JSTL标签库的一个特点。
      函数标签库：用来读取已经定义的某个函数。

      此外，JSTL还提供了EL表达式语言（Expression Language）来进行辅助的工作。
      JSTL标签库由标签库和EL表达式语言两个部分组成。EL在JSTL 1.0规范中被引入，当时用来作为Java表达式来工作，而该表达式必须配合JSTL的标签库才能得到需要的结果。
      说明：在JSTL 1.1规范中，JSP2.0容器已经能够独立的理解任何EL表达式。EL可以独立出现在JSP页面的任何角落。本文随后的内容将以JSTL 1.1规范作为介绍的重点。

9.2.1 JSTL EL 表达式语言简介
      EL是从JavaScript脚本语言得到启发的一种表达式语言，它借鉴了JavaScript多类型转换无关性的特点。在使用EL从scope中得到参数时可以自动转换类型，因此对于类型的限制更加宽松。Web服务器对于request请求参数通常会以String类型来发送，在得到时使用的Java语言脚本就应该是request.getParameter(“XXX”)，这样的话，对于实际应用还必须进行强制类型转换。而EL就将用户从这种类型转换的繁琐工作脱离出来，允许用户直接使用EL表达式取得的值，而不用关心它是什么类型。
      下面的示例就是一个EL表达式，见例9.1。
      例9.1：简单EL表达式

      <%@ page contentType="text/html; charset=UTF-8"%>
      <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
      <html>
       <body> ${sampleValue + 1} <br> </body>
      </html>

      这个示例将在JSP页面显示为“1”，EL表达式必须以“${XXX}”来表示，其中“XXX”部分就是具体表达式内容，“${}”将这个表达式内容包含在其中作为EL表达式的定义。本示例可以在满足JSP2.0规范的任何Web应用服务器中使用。

9.2.2 EL 表达式的默认变量
一个EL表达式包含变量和操作符两个内容。任何存在于JSP作用范围的JavaBean都可以被转化成EL表达式来使用，它所包含的默认变量如下：

1．默认变量pageScope、requestScope、sessionScope、applicationScope
这4个默认变量包含Scope作用范围的参数集合，相当于被保存在java.util.Map中的某个参数。下面看简单的示例9.2：

例9.2：使用sessionScope变量的EL表达式

<%request.getSession().setAttribute("sampleValue", new Integer(10));%>
${sessionScope.sampleValue}

取得保存在Session中参数的sessionScope变量的EL表达式，“.”是property访问操作符，在这里表示从Session中取得“键”为“sampleValue”的参数，并显示出来。显示结果为“10”。

2．默认变量param、paramValues
这两个默认变量包含请求参数的集合，param表明请求包含的参数为单一控件，paramValues表明请求包含的参数为控件数组。下面看一个简单示例9.3：

例9.3：提交请求的页面和接受的页面

<%@ page contentType="text/html; charset=UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<body>
     <form action="SampleJsp.jsp">
    <input type="text" name="sampleValue" value="10">
    <input type="text" name="sampleValue" value="11">
    <input type="text" name="sampleValue" value="12">
    <input type="text" name="sampleSingleValue" value="SingleValue">
    <input type="submit" value="Submit">
    </form>
</body>
</html>

在这个页面中定义了两组控件，控件名为“sampleValue”的是一套控件数组，控件名为“sampleSingleValue”的是单一控件，通过递交将请求参数传送到SampleJsp.jsp。

<%@ page contentType="text/html; charset=UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<body>
${paramValues.sampleValue[2]} <br>
${param.sampleSingleValue} <br>
</body>
</html>

这是请求转发到的页面，通过EL表达式的paramValues变量得到控件数组中最后一个控件的递交参数，通过EL表达式的param变量得到单一控件的递交参数。控件数组参数的EL表达式使用“[]”来指定数组下标。本示例将显示控件数组中最后一个控件的值“12”和单一控件的值“SingleValue”。

3．默认变量header、headerValues
这两个默认变量包含请求参数头部信息的集合，header变量表示单一头部信息，headerValues则表示数组型的头部信息。

4．默认变量cookie
包含所有请求的cookie集合，集合中的每个对象对应javax.servlet.http.Cookie。

5．默认变量initParam
包含所有应用程序初始化参数的集合。

6．默认变量pageContext
等价于page环境类javax.servlet.jsp.PageContext的实例，用来提供访问不同的请求参数。
11个默认变量几乎包含了Web应用的所有基本操作，若一个表达式不使用这些变量而直接使用参数名，那么就采用就近原则。该表达式将使用最近取得的参数值。

标签库介绍

表达式的操作符
EL表达式中还有许多操作符可以帮助完成各种所需的操作，之前的示例中“.”、“[]”就是其中的两个，下面将用表9.1来展示所有操作符及它们各自的功能。

表9.1 EL表达式的操作符

操作符	功能和作用
.	访问一个bean属性或者Map entry
[]	访问一个数组或者链表元素
()	对子表达式分组，用来改变赋值顺序
? :	条件语句，比如：条件?ifTrue:ifFalse 如果条件为真，表达式值为前者，反之为后者
+	数学运算符，加操作
-	数学运算符，减操作或者对一个值取反
*	数学运算符，乘操作
/ 或div	数学运算符，除操作
% 或mod	数学运算符，模操作(取余)
== 或eq	逻辑运算符，判断符号左右两端是否相等，如果相等返回true，否则返回false
!= 或ne	逻辑运算符，判断符号左右两端是否不相等，如果不相等返回true，否则返回false
< 或lt	逻辑运算符，判断符号左边是否小于右边，如果小于返回true，否则返回false
> 或gt	逻辑运算符，判断符号左边是否大于右边，如果大于返回true，否则返回false
<= 或le	逻辑运算符，判断符号左边是否小于或者等于右边，如果小于或者等于返回true，否则返回false
>= 或ge	逻辑运算符，判断符号左边是否大于或者等于右边，如果大于或者等于返回true，否则返回false
&& 或and	逻辑运算符，与操作赋。如果左右两边同为true返回true，否则返回false
\|\| 或or	逻辑运算符，或操作赋。如果左右两边有任何一边为true返回true，否则返回false
! 或not	逻辑运算符，非操作赋。如果对true取运算返回false，否则返回true
empty	用来对一个空变量值进行判断: null、一个空String、空数组、空Map、没有条目的Collection集合
func(args)	调用方法, func是方法名，args是参数，可以没有，或者有一个、多个参数.参数间用逗号隔开

这些操作符都是极其有用的，下面通过几个示例来演示它们的使用方法：

例9.4：几组操作符的示例

${pageScope.sampleValue + 12} <br>           //显示12
${(pageScope.sampleValue + 12)/3} <br>     //显示4.0
${(pageScope.sampleValue + 12) /3==4} <br>         //显示true
${(pageScope.sampleValue + 12) /3>=5} <br>         //显示false
<input type="text" name="sample1" value="${pageScope.sampleValue + 10}"> //显示值为10的Text控件

可以看到，对于这些示例，程序设计者完全无需管理它们的类型转换，在表达式内部都已经处理了。有了EL表达式，在JSP页面的编程变得更灵活，也更容易。

标签库介绍
在JSTL1.1中有以下这些标签库是被支持的：Core标签库、XML processing标签库、I18N formatting标签库、Database access标签库、Functions标签库。
对应的标识符见表9.2所示：

表9.2 标签库的标识符

标签库	URI	前缀
Core	http://java.sun.com/jsp/jstl/core	c
XML processing	http://java.sun.com/jsp/jstl/xml	x
I18N formatting	http://java.sun.com/jsp/jstl/fmt	fmt
Database access	http://java.sun.com/jsp/jstl/sql	sql
Functions	http://java.sun.com/jsp/jstl/functions	fn

下面看例9.5，简单使用标签库的示例。

例9.5：简单JSTL标签库示例

<%@ page contentType="text/html; charset=UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<body>
<c:forEach var="i" begin="1" end="10" step="1"> ${i} <br /></c:forEach>
</body>
</html>

在该示例的JSP页面中声明了将使用Core标签库，它的URI为“http://java.sun.com/jsp/jstl/core”，前缀为“c”。之后，页面中<c:forEach>标签就是使用了JSTL的标签进行了工作。对于该标签的功能，这里暂时不作具体讲解，只是让读者能够有个简单的概念，了解怎样定义和使用标签库。

标签库
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:out>标签是一个最常用的标签，用于在JSP中显示数据。它的属性和描述如表9.3所示：

表9.3　<c:out>标签属性和说明

属性	描述
value	输出到页面的数据，可以是EL表达式或常量（必须）
default	当value为null时显示的数据（可选）
escapeXml	当设置为true时会主动更换特殊字符，比如“<,>,&”（可选，默认为true）

在JSTL1.0的时候，在页面显示数据必须使用<c:out>来进行。然而，在JSTL1.1中，由于JSP2.0规范已经默认支持了EL表达式，因此可以直接在JSP页面使用表达式。下面看一个示例。

<c:out value="${sessionScope.anyValue}" default="no value" escapeXml="false"/>

该示例将从Session查找名为“anyValue”的参数，并显示在页面，若没有找到则显示“no value”。

<c: > 标签

用于赋值的<c:set>标签
<c:set>标签用于为变量或JavaBean中的变量属性赋值的工作。它的属性和描述如表9.4所示：

表9.4　<c:set>标签属性和说明

属性	描述
value	值的信息，可以是EL表达式或常量
target	被赋值的JavaBean实例的名称，若存在该属性则必须存在property属性（可选）
property	JavaBean实例的变量属性名称（可选）
var	被赋值的变量名（可选）
scope	变量的作用范围，若没有指定，默认为page（可选）

当不存在value的属性时，将以包含在标签内的实体数据作为赋值的内容。下面看一个示例：

<c:set value="this is andy" var="oneString"/>
${oneString} <br>

该示例将为名为“oneString”的变量赋值为“this is andy”，其作用范围为page。

9.3.3 用于删除的 <c:remove> 标签
<c:remove>标签用于删除存在于scope中的变量。它的属性和描述如表9.5所示：

表9.5　<c:remove>标签属性和说明

属性	描述
var	需要被删除的变量名
scope	变量的作用范围，若没有指定，默认为全部查找（可选）

下面看一个示例：

<c:remove var="sampleValue" scope="session"/>
${sessionScope.sampleValue} <br>

该示例将存在于Session中名为“sampleValue”的变量删除。下一句EL表达式显示该变量时，该变量已经不存在了。

9.3.4 用于异常捕获的 <c:catch> 标签
<c:catch>标签允许在JSP页面中捕捉异常。它包含一个var属性，是一个描述异常的变量，改变量可选。若没有var属性的定义，那么仅仅捕捉异常而不做任何事情，若定义了var属性，则可以利用var所定义的异常变量进行判断转发到其他页面或提示报错信息。看一个示例。

<c:catch var="err"> ${param.sampleSingleValue[9] == 3}</c:catch>
${err}

当“${param.sampleSingleValue[9] == 3}”表达式有异常时，可以从var属性“err”得到异常的内容，通常判断“err”是否为null来决定错误信息的提示。

9.3.5 用于判断的 <c:if> 标签
<c:if>标签用于简单的条件语句。它的属性和描述如表9.6所示：

表9.6　<c:if>标签属性和说明

属性	描述
test	需要判断的条件
var	保存判断结果true或false的变量名，该变量可供之后的工作使用（可选）
scope	变量的作用范围，若没有指定，默认为保存于page范围中的变量（可选）

下面看一个示例：

<c:if test="${paramValues.sampleValue[2] == 12}" var="visits">It is 12</c:if><br>
${visits} <br>

该示例将判断request请求提交的传入控件数组参数中，下标为“2”的控件内容是否为“12”，若为12则显示“It is 12”。判断结果被保存在page范围中的“visits”变量中。

9.3.6 用于复杂判断的 <c:choose> 、 <c:when> 、 <c:otherwise> 标签
这三个标签用于实现复杂条件判断语句，类似“if,elseif”的条件语句。

         <c:choose>标签没有属性，可以被认为是父标签，<c:when>、<c:otherwise>将作为其子标签来使用。
         <c:when>标签等价于“if”语句，它包含一个test属性，该属性表示需要判断的条件。
         <c:otherwise>标签没有属性，它等价于“else”语句。

下面看一个复杂条件语句的示例。

<c:choose>
         <c:when test="${paramValues.sampleValue[2] == 11}">
                   not 12 not 13,it is 11
         </c:when>
         <c:when test="${paramValues.sampleValue[2] == 12}">
                   not 11 not 13,it is 12
         </c:when>
         <c:when test="${paramValues.sampleValue[2] == 13}">
                   not 11 not 12,it is 13
         </c:when>
         <c:otherwise>
                   not 11 、12、13
         </c:otherwise>
</c:choose>

该示例将判断request请求提交的传入控件数组参数中，下标为“2”控件内容是否为“11”或“12”或“13”，并根据判断结果显示各自的语句，若都不是则显示“not 11 、12、13”。

9.3.7 用于循环的 <c:forEach> 标签
<c:forEach>为循环控制标签。它的属性和描述如表9.7所示：

表9.7　<c:forEach>标签属性和说明

属性	描述
items	进行循环的集合（可选）
begin	开始条件（可选）
end	结束条件（可选）
step	循环的步长，默认为1（可选）
var	做循环的对象变量名，若存在items属性，则表示循环集合中对象的变量名（可选）
varStatus	显示循环状态的变量（可选）

下面看一个集合循环的示例。

<%ArrayList arrayList = new ArrayList();
                   arrayList.add("aa");
                   arrayList.add("bb");
                   arrayList.add("cc");
%>
<%request.getSession().setAttribute("arrayList", arrayList);%>
<c:forEach items="${sessionScope.arrayList}" var="arrayListI">
         ${arrayListI}
</c:forEach>

该示例将保存在Session中的名为“arrayList”的ArrayList类型集合参数中的对象依次读取出来，items属性指向了ArrayList类型集合参数，var属性定义了一个新的变量来接收集合中的对象。最后直接通过EL表达式显示在页面上。下面看一个简单循环的示例。

<c:forEach var="i" begin="1" end="10" step="1">
${i}<br />
</c:forEach>

该示例从“1”循环到“10”，并将循环中变量“i”显示在页面上。

9.3.8 用于分隔字符的 <c:forTokens> 标签
<c:forTokens>标签可以根据某个分隔符分隔指定字符串，相当于java.util.StringTokenizer类。它的属性和描述如表9.8所示：

表9.8　<c:forTokens>标签属性和说明

属性	描述
items	进行分隔的EL表达式或常量
delims	分隔符
begin	开始条件（可选）
end	结束条件（可选）
step	循环的步长，默认为1（可选）
var	做循环的对象变量名（可选）
varStatus	显示循环状态的变量（可选）

下面看一个示例。

<c:forTokens items="aa,bb,cc,dd" begin="0" end="2" step="2" delims="," var="aValue">
${aValue}
</c:forTokens>

需要分隔的字符串为“aa,bb,cc,dd”，分隔符为“,”。begin属性指定从第一个“,”开始分隔，end属性指定分隔到第三个“,”，并将做循环的变量名指定为“aValue”。由于步长为“2”，使用EL表达式${aValue}只能显示“aa

<x: > 标签

9.3.9 用于包含页面的<c:import>
<c:import>标签允许包含另一个JSP页面到本页面来。它的属性和描述如表9.9所示：

表9.9　<c:import>标签属性和说明

属性	描述
rl	需要导入页面的URL
context	Web Context该属性用于在不同的Context下导入页面，当出现context属性时，必须以“/”开头，此时也需要url属性以“/”开头（可选）
charEncoding	导入页面的字符集（可选）
var	可以定义导入文本的变量名（可选）
scope	导入文本的变量名作用范围（可选）
varReader	接受文本的java.io.Reader类变量名（可选）

下面看一个示例。

<c:import url="/MyHtml.html" var="thisPage" />
<c:import url="/MyHtml.html" context=”/sample2” var="thisPage"/>
<c:import url="www.sample.com/MyHtml.html" var="thisPage"/>

该示例演示了三种不同的导入方法，第一种是在同一 Context 下的导入，第二种是在不同的 Context 下导入，第三种是导入任意一个 URL 。

9.3.10 用于得到URL地址的<c:url>标签
<c:url> 标签用于得到一个 URL 地址。它的属性和描述如表 9.10 所示：

表9.10 <c:url>标签属性和说明

属性	描述
value	页面的URL地址
context	Web Context该属性用于得到不同Context下的URL地址，当出现context属性时，必须以“/”开头，此时也需要url属性以“/”开头（可选）
charEncoding	URL的字符集（可选）
var	存储URL的变量名（可选）
scope	变量名作用范围（可选）

下面看一个示例：

<c:url value="/MyHtml.html" var="urlPage" />
<a href="${urlPage}">link</a>

得到了一个 URL 后，以 EL 表达式放入 <a> 标签的 href 属性，达到链接的目的。

9.3.11 用于页面重定向的<c:redirect>标签
<c:redirect> 用于页面的重定向，该标签的作用相当于 response.setRedirect 方法的工作。它包含 url 和 context 两个属性，属性含义和 <C:url> 标签相同。下面看一个示例。

<c:redirect url="/MyHtml.html"/>

该示例若出现在 JSP 中，则将重定向到当前 Web Context 下的“ MyHtml.html ”页面，一般会与 <c:if> 等标签一起使用。

9.3.12 用于包含传递参数的<c:param>标签
<c:param> 用来为包含或重定向的页面传递参数。它的属性和描述如表 9.11 所示：

表9.11　<c:param>标签属性和说明

属性	描述
name	传递的参数名
value	传递的参数值（可选）

下面是一个示例：

<c:redirect url="/MyHtml.jsp">
<c:param name="userName" value=”RW” />
</c:redirect>

该示例将为重定向的“ MyHtml.jsp ”传递指定参数“ userName=’RW’ ”。

9.4 JSTL XML processing标签库
在企业级应用越来越依赖 XML 的今天， XML 格式的数据被作为信息交换的优先选择。 XML processing 标签库为程序设计者提供了基本的对 XML 格式文件的操作。在该标签库中的标签一共有 10 个，被分为了三类，分别是：

         XML核心标签：<x:parse>、<x:out>、<x:set>。
         XML流控制标签：<x:if>、<x:choose>、<x:when>、<x:otherwise>、<x:forEach>。
         XML转换标签：<x:transform>、<x:param>。

由于该组标签库专注于对某一特定领域的实现，因此本书将只选择其中常见的一些标签和属性进行介绍。

9.4.1 用于解析XML文件的<x:parse>标签
<x:parse> 标签是该组标签库的核心，从其标签名就可以知道，它是作为解析 XML 文件而存在的。它的属性和描述如表 9.12 所示：

表9.12　<x:parse>标签属性和说明

属性	描述
doc	源XML的内容，该属性的内容应该为String类型或者java.io.Reader的实例，可以用xml属性来替代，但是不被推荐
var	将解析后的XML保存在该属性所指定的变量中，之后XML processing标签库中的其他标签若要取XML中的内容就可以从该变量中得到（可选）
scope	变量的作用范围（可选）
varDom	指定保存的变量为org.w3c.dom.Document接口类型（可选）
scopeDom	org.w3c.dom.Document的接口类型变量作用范围（可选）
systemId	定义一个URI，该URI将被使用到XML文件中以接入其他资源文件（可选）
filter	该属性必须为org.xml.sax.XMLFilter类的一个实例，可以使用EL表达式传入，将对XML文件做过滤得到自身需要的部分（可选）

其中， var 、 scope 和 varDom 、 scopeDom 不应该同时出现，而应该被视为两个版本来使用，二者的变量都可以被 XML processing 标签库的其他标签来使用。

<x:parse> 标签单独使用的情况很少，一般会结合 XML processing 标签库中的其他标签来一起工作。下面看一个示例。

首先给出一个简单的 XML 文件，将对该 XML 文件做解析，该 XML 文件名为 SampleXml.xml 。

<?xml version="1.0" encoding="UTF-8"?>
<xml-body>
         <name>RW</name>
         <passWord>123456</passWord>
         <age>28</age>
         <books>
                   <book>book1</book>
                   <book>book2</book>
                   <book>book3</book>
         </books>
</xml-body>

标签库的工作：

<c:import var="xmlFile" url="http://localhost:8080/booksamplejstl/SampleXml.xml"/>
<x:parse var="xmlFileValue" doc="${xmlFile}"/>

<fmt: > 标签

看到I18N就应该想到知识“国际化”，I18N formatting标签库就是用于在JSP页面中做国际化的动作。在该标签库中的标签一共有12个，被分为了两类，分别是：
国际化核心标签：<fmt:setLocale>、<fmt:bundle>、<fmt:setBundle>、<fmt:message>、<fmt:param>、<fmt:requestEncoding>。
格式化标签：<fmt:timeZone>、<fmt:setTimeZone>、<fmt:formatNumber>、<fmt:parseNumber>、<fmt:formatDate>、<fmt:parseDate>。

下面只选择其中常见的一些标签和属性进行介绍。

9.5.1 用于设置本地化环境的<fmt:setLocale>标签
<fmt:setLocale>标签用于设置Locale环境。它的属性和描述如表9.17所示：

表9.17　<fmt:setLocale>标签属性和说明

属性	描述
value	Locale环境的指定，可以是java.util.Locale或String类型的实例
scope	Locale环境变量的作用范围（可选）

下面看一个示例：

<fmt:setLocale value="zh_TW"/>

表示设置本地环境为繁体中文。

9.5.2 用于资源文件绑定的<fmt:bundle>、<fmt:setBundle>标签
这两组标签用于资源配置文件的绑定，唯一不同的是<fmt:bundle>标签将资源配置文件绑定于它标签体中的显示，<fmt:setBundle>标签则允许将资源配置文件保存为一个变量，在之后的工作可以根据该变量来进行。

根据Locale环境的不同将查找不同后缀的资源配置文件，这点在国际化的任何技术上都是一致的，通常来说，这两种标签单独使用是没有意义的，它们都会与I18N formatting标签库中的其他标签配合使用。它们的属性和描述如表9.18所示：

表9.18　<fmt:bundle>、<fmt:setBundle>标签属性和说明

属性	描述
basename	资源配置文件的指定，只需要指定文件名而无须扩展名，二组标签共有的属性
var	<fmt:setBundle>独有的属性，用于保存资源配置文件为一个变量
scope	变量的作用范围

下面看一个示例

<fmt:setLocale value="zh_CN"/>
<fmt:setBundle basename="applicationMessage" var="applicationBundle"/>

该示例将会查找一个名为applicationMessage_zh_CN.properties的资源配置文件，来作为显示的Resource绑定。

9.5.3 用于显示资源配置文件信息的<fmt:message>标签
用于信息显示的标签，将显示资源配置文件中定义的信息。它的属性和描述如表9.19所示：

表9.19　<fmt:message>标签属性和说明

属性	描述
key	资源配置文件的“键”指定
bundle	若使用<fmt:setBundle>保存了资源配置文件，该属性就可以从保存的资源配置文件中进行查找
var	将显示信息保存为一个变量
scope	变量的作用范围

下面看一个示例：

<fmt:setBundle basename="applicationMessage" var="applicationBundle"/>
<fmt:bundle basename="applicationAllMessage">
         <fmt:message key="userName" />
         <p>
         <fmt:message key="passWord" bundle="${applicationBundle}" />
</fmt:bundle>

该示例使用了两种资源配置文件的绑定的做法，“ applicationMessage ”资源配置文件利用<fmt:setBundle>标签被赋于了变量“ applicationBundle ”，而作为<fmt:bundle>标签定义的“ applicationAllMessage ”资源配置文件作用于其标签体内的显示。

第一个<fmt:message>标签将使用“ applicationAllMessage ”资源配置文件中“键”为“ userName ”的信息显示。
第二个<fmt:message>标签虽然被定义在<fmt:bundle>标签体内，但是它使用了bundle属性，因此将指定之前由<fmt:setBundle>标签保存的“ applicationMessage ”资源配置文件，该“键”为“ passWord ”的信息显示。

9.5.4 用于参数传递的<fmt:param>标签
<fmt:param>标签应该位于<fmt:message>标签内，将为该消息标签提供参数值。它只有一个属性value。
<fmt:param>标签有两种使用版本，一种是直接将参数值写在value属性中，另一种是将参数值写在标签体内。

9.5.6 用于为请求设置字符编码的<fmt:requestEncoding>标签
<fmt:requestEncoding>标签用于为请求设置字符编码。它只有一个属性value，在该属性中可以定义字符编码。

9.5.7 用于设定时区的<fmt:timeZone>、<fmt:setTimeZone>标签
这两组标签都用于设定一个时区。唯一不同的是<fmt:timeZone>标签将使得在其标签体内的工作可以使用该时区设置，<fmt:setBundle>标签则允许将时区设置保存为一个变量，在之后的工作可以根据该变量来进行。它们的属性和描述如表9.20所示：

表9.20　<fmt:timeZone>、<fmt:setTimeZone>标签属性和说明

属性	描述
value	时区的设置
var	<fmt:setTimeZone>独有的属性，用于保存时区为一个变量
scope	变量的作用范围

9.5.8 用于格式化数字的<fmt:formatNumber>标签
<fmt: formatNumber > 标签用于格式化数字。它的属性和描述如表9.21所示：

表9.21　<fmt:formatNumber>标签属性和说明

属性	描述
value	格式化的数字，该数值可以是String类型或java.lang.Number类型的实例
type	格式化的类型
pattern	格式化模式
var	结果保存变量
scope	变量的作用范围
maxIntegerDigits	指定格式化结果的最大值
minIntegerDigits	指定格式化结果的最小值
maxFractionDigits	指定格式化结果的最大值，带小数
minFractionDigits	指定格式化结果的最小值，带小数

<fmt:formatNumber>标签实际是对应java.util.NumberFormat类，type属性的可能值包括currency（货币）、number（数字）和percent（百分比）。

下面看一个示例。

<fmt:formatNumber value="1000.888" type="currency" var="money"/>

该结果将被保存在“ money ”变量中，将根据Locale环境显示当地的货币格式。

9.5.9 用于解析数字的<fmt:parseNumber>标签
<fmt:parseNumber>标签用于解析一个数字，并将结果作为java.lang.Number类的实例返回。<fmt:parseNumber>标签看起来和<fmt:formatNumber>标签的作用正好相反。它的属性和描述如表9.22所示：

表9.22　<fmt:parseNumber>标签属性和说明

属性	描述
value	将被解析的字符串
type	解析格式化的类型
pattern	解析格式化模式
var	结果保存变量，类型为java.lang.Number
scope	变量的作用范围
parseLocale	以本地化的形式来解析字符串，该属性的内容应为String或java.util.Locale类型的实例

下面看一个示例。

<fmt:parseNumber value="15%" type="percent" var="num"/>

解析之后的结果为“ 0.15 ”。

9.5.10 用于格式化日期的<fmt:formatDate>标签
<fmt:formatDate>标签用于格式化日期。它的属性和描述如表9.23所示：

表9.23　<fmt:formatDate>标签属性和说明

属性	描述
value	格式化的日期，该属性的内容应该是java.util.Date类型的实例
type	格式化的类型
pattern	格式化模式
var	结果保存变量
scope	变量的作用范围
timeZone	指定格式化日期的时区

<fmt:formatDate>标签与<fmt:timeZone>、<fmt:setTimeZone>两组标签的关系密切。若没有指定 timeZone属性，也可以通过<fmt:timeZone>、<fmt:setTimeZone>两组标签设定的时区来格式化最后的结果。

9.5.11 用于解析日期的<fmt:parseDate>标签
<fmt:parseDate>标签用于解析一个日期，并将结果作为java.lang.Date类型的实例返回。<fmt:parseDate>标签看起来和<fmt:formatDate>标签的作用正好相反。它的属性和描述如表9.24所示：

表9.24　<fmt:parseDate>标签属性和说明

属性	描述
value	将被解析的字符串
type	解析格式化的类型
pattern	解析格式化模式
var	结果保存变量，类型为java.lang.Date
scope	变量的作用范围
parseLocale	以本地化的形式来解析字符串，该属性的内容为String或java.util.Locale类型的实例
timeZone	指定解析格式化日期的时区

<fmt:parseNumber>和<fmt:parseDate>两组标签都实现解析字符串为一个具体对象实例的工作，因此，这两组解析标签对var属性的字符串参数要求非常严格。就JSP页面的表示层前段来说，处理这种解析本不属于份内之事，因此<fmt:parseNumber>和<fmt:parseDate>两组标签应该尽量少用，替代工作的地方应该在服务器端表示层的后段，比如在Servlet中。

<sql:> 标签

9.6 Database access 标签库
Database access标签库中的标签用来提供在JSP页面中可以与数据库进行交互的功能，虽然它的存在对于早期纯JSP开发的应用以及小型的开发有着意义重大的贡献，但是对于MVC模型来说，它却是违反规范的。因为与数据库交互的工作本身就属于业务逻辑层的工作，所以不应该在JSP页面中出现，而是应该在模型层中进行。

对于Database access标签库本书不作重点介绍，只给出几个简单示例让读者略微了解它们的功能。

Database access标签库有以下6组标签来进行工作：<sql:setDataSource>、<sql:query>、<sql:update>、<sql:transaction>、<sql:setDataSource>、<sql:param>、<sql:dateParam>。

9.6.1 用于设置数据源的 <sql:setDataSource> 标签
<sql:setDataSource>标签用于设置数据源，下面看一个示例：

<sql:setDataSource
         var="dataSrc"
         url="jdbc:postgresql://localhost:5432/myDB"
         driver="org.postgresql.Driver"
         user="admin"
         password="1111"/>

该示例定义一个数据源并保存在“ dataSrc ”变量内。

9.6.2 用于查询的 <sql:query> 标签
<sql:query>标签用于查询数据库，它标签体内可以是一句查询SQL。下面看一个示例：

<sql:query var="queryResults" dataSource="${dataSrc}">
select * from table1
</sql:query>

该示例将返回查询的结果到变量“ queryResults ”中，保存的结果是javax.servlet.jsp.jstl.sql.Result类型的实例。要取得结果集中的数据可以使用<c:forEach>循环来进行。下面看一个示例。

<c:forEach var="row" items="${queryResults.rows}">
      <tr>
               <td>${row.userName}</td>
                <td>${row.passWord}</td>
      </tr>
</c:forEach>

“ rows ”是javax.servlet.jsp.jstl.sql.Result实例的变量属性之一，用来表示数据库表中的“列”集合，循环时，通过“ ${row.XXX} ”表达式可以取得每一列的数据，“ XXX ”是表中的列名。

9.6.3 用于更新的 <sql:update> 标签
<sql:update>标签用于更新数据库，它的标签体内可以是一句更新的SQL语句。其使用和<sql:query>标签没有什么不同。

9.6.4 用于事务处理的 <sql:transaction> 标签
<sql:transaction>标签用于数据库的事务处理，在该标签体内可以使用<sql:update>标签和<sql:query>标签，而<sql:transaction>标签的事务管理将作用于它们之上。
<sql:transaction>标签对于事务处理定义了read_committed、read_uncommitted、repeatable_read、serializable4个隔离级别。

9.6.5 用于事务处理的 <sql:param> 、 <sql:dateParam> 标签
这两个标签用于向SQL语句提供参数，就好像程序中预处理SQL的“ ? ”一样。<sql:param>标签传递除java.util.Date类型以外的所有相融参数，<sql:dateParam>标签则指定必须传递java.util.Date类型的参数。

<fn:> 标签

9.7 Functions 标签库
称呼Functions标签库为标签库，倒不如称呼其为函数库来得更容易理解些。因为Functions标签库并没有提供传统的标签来为JSP页面的工作服务，而是被用于EL表达式语句中。在JSP2.0规范下出现的Functions标签库为EL表达式语句提供了许多更为有用的功能。Functions标签库分为两大类，共16个函数。

长度函数：fn:length
字符串处理函数：fn:contains、fn:containsIgnoreCase、fn:endsWith、fn:escapeXml、fn:indexOf、fn:join、fn:replace、fn:split、fn:startsWith、fn:substring、fn:substringAfter、fn:substringBefore、fn:toLowerCase、fn:toUpperCase、fn:trim

以下是各个函数的用途和属性以及简单示例。

9.7.1 长度函数 fn:length 函数
长度函数fn:length的出现有重要的意义。在JSTL1.0中，有一个功能被忽略了，那就是对集合的长度取值。虽然java.util.Collection接口定义了size方法，但是该方法不是一个标准的JavaBean属性方法（没有get,set方法），因此，无法通过EL表达式“ ${collection.size} ”来轻松取得。

fn:length函数正是为了解决这个问题而被设计出来的。它的参数为input，将计算通过该属性传入的对象长度。该对象应该为集合类型或String类型。其返回结果是一个int类型的值。下面看一个示例。

<%ArrayList arrayList1 = new ArrayList();
                            arrayList1.add("aa");
                            arrayList1.add("bb");
                            arrayList1.add("cc");

%>
<%request.getSession().setAttribute("arrayList1", arrayList1);%>
${fn:length(sessionScope.arrayList1)}

假设一个ArrayList类型的实例“ arrayList1 ”，并为其添加三个字符串对象，使用fn:length函数后就可以取得返回结果为“ 3 ”。

9.7.2 判断函数 fn:contains 函数
fn:contains函数用来判断源字符串是否包含子字符串。它包括string和substring两个参数，它们都是String类型，分布表示源字符串和子字符串。其返回结果为一个boolean类型的值。下面看一个示例。

${fn:contains("ABC", "a")}<br>
${fn:contains("ABC", "A")}<br>

前者返回“ false ”，后者返回“ true ”。

9.7.3 fn:containsIgnoreCase函数
fn:containsIgnoreCase函数与fn:contains函数的功能差不多，唯一的区别是fn:containsIgnoreCase函数对于子字符串的包含比较将忽略大小写。它与fn:contains函数相同，包括string和substring两个参数，并返回一个boolean类型的值。下面看一个示例。

${fn:containsIgnoreCase("ABC", "a")}<br>
${fn:containsIgnoreCase("ABC", "A")}<br>

前者和后者都会返回“ true ”。

9.7.4 词头判断函数 fn:startsWith 函数
fn:startsWith函数用来判断源字符串是否符合一连串的特定词头。它除了包含一个string参数外，还包含一个subffx参数，表示词头字符串，同样是String类型。该函数返回一个boolean类型的值。下面看一个示例。

${fn:startsWith ("ABC", "ab")}<br>
${fn:startsWith ("ABC", "AB")}<br>

前者返回“ false ”，后者返回“ true ”。

9.7.5 词尾判断函数 fn:endsWith 函数
fn:endsWith函数用来判断源字符串是否符合一连串的特定词尾。它与fn:startsWith函数相同，包括string和subffx两个参数，并返回一个boolean类型的值。下面看一个示例。

${fn:endsWith("ABC", "bc")}<br>
${fn:endsWith("ABC", "BC")}<br>

前者返回“ false ”，后者返回“ true ”。

9.7.6 字符实体转换函数 fn:escapeXml 函数
fn:escapeXml函数用于将所有特殊字符转化为字符实体码。它只包含一个string参数，返回一个String类型的值。

9.7.8 字符匹配函数 fn:indexOf 函数
fn:indexOf函数用于取得子字符串与源字符串匹配的开始位置，若子字符串与源字符串中的内容没有匹配成功将返回“ -1 ”。它包括string和substring两个参数，返回结果为int类型。下面看一个示例。

${fn:indexOf("ABCD","aBC")}<br>
${fn:indexOf("ABCD","BC")}<br>

前者由于没有匹配成功，所以返回-1，后者匹配成功将返回位置的下标，为1。

9.7.9 分隔符函数 fn:join 函数
fn:join函数允许为一个字符串数组中的每一个字符串加上分隔符，并连接起来。它的参数、返回结果和描述如表9.25所示：

表9.25　fn:join函数

参数	描述
array	字符串数组。其类型必须为String[]类型
separator	分隔符。其类型必须为String类型
返回结果	返回一个String类型的值

下面看一个示例。

<% String[] stringArray = {"a","b","c"}; %>
<%request.getSession().setAttribute("stringArray", stringArray);%>
${fn:join(sessionScope.stringArray,";")}<br>

定义数组并放置到Session中，然后通过Session得到该字符串数组，使用fn:join函数并传入分隔符“ ; ”，得到的结果为“ a;b;c ”。

9.7.10 替换函数 fn:replace 函数
fn:replace函数允许为源字符串做替换的工作。它的参数、返回结果和描述如表9.26所示：

表9.26　fn:replace函数

参数	描述
inputString	源字符串。其类型必须为String类型
beforeSubstring	指定被替换字符串。其类型必须为String类型
afterSubstring	指定替换字符串。其类型必须为String类型
返回结果	返回一个String类型的值

下面看一个示例。

${fn:replace("ABC","A","B")}<br>

将“ ABC ”字符串替换为“ BBC ”，在“ ABC ”字符串中用“ B ”替换了“ A ”。

9.7.11 分隔符转换数组函数 fn:split 函数
fn:split函数用于将一组由分隔符分隔的字符串转换成字符串数组。它的参数、返回结果和描述如表9.27所示：

表9.27　fn:split函数

参数	描述
string	源字符串。其类型必须为String类型
delimiters	指定分隔符。其类型必须为String类型
返回结果	返回一个String[]类型的值

下面看一个示例。

${fn:split("A,B,C",",")}<br>

将“ A,B,C ”字符串转换为数组{A,B,C}。

9.7.12 字符串截取函数 fn:substring 函数
fn:substring函数用于截取字符串。它的参数、返回结果和描述如表9.28所示：

表9.28　fn:substring函数

参数	描述
string	源字符串。其类型必须为String类型
beginIndex	指定起始下标（值从0开始）。其类型必须为int类型
endIndex	指定结束下标（值从0开始）。其类型必须为int类型
返回结果	返回一个String类型的值

下面看一个示例。

${fn:substring("ABC","1","2")}<br>

截取结果为“ B ”。

9.7.14 起始到定位截取字符串函数 fn:substringBefore 函数
fn:substringBefore函数允许截取源字符从开始到某个字符串。它的参数和fn:substringAfter函数相同，不同的是substring表示的是结束字符串。下面看一个示例。

${fn:substringBefore("ABCD","BC")}<br>

截取的结果为“ A ”。

9.7.15 小写转换函数 fn:toLowerCase 函数
fn:toLowerCase函数允许将源字符串中的字符全部转换成小写字符。它只有一个表示源字符串的参数string，函数返回一个String类型的值。下面看一个示例。

${fn:toLowerCase("ABCD")}<br>

转换的结果为“ abcd ”。

9.7.16大写转换函数 fn:toUpperCase 函数
fn:toUpperCase函数允许将源字符串中的字符全部转换成大写字符。它与fn:toLowerCase函数相同，也只有一个String参数，并返回一个String类型的值。下面看一个示例。

${fn:toUpperCase("abcd")}<br>

转换的结果为“ ABCD ”。

9.7.17空格删除函数 fn:trim 函数
fn:trim函数将删除源字符串中结尾部分的“空格”以产生一个新的字符串。它与fn:toLowerCase函数相同，只有一个String参数，并返回一个String类型的值。下面看一个示例。

${fn:trim("AB C ")}D<br>

转换的结果为“ AB CD ”，注意，它将只删除词尾的空格而不是全部，因此“ B ”和“ C ”之间仍然留有一个空格。