JSTL介绍

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.1JSTL 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:提交请求的页面和接受的页面

1
2
3
4
5
6
7
8
9
10
11
12
13
<%@ 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。

1
2
3
4
5
6
7
8
<%@ 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时会主动更换特殊字符,比如“&lt;,&gt;,&amp;”(可选,默认为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}

该示例将保存在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”)}

将“ 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”,”,”)}

将“ 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”)}

截取结果为“ 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 ”之间仍然留有一个空格。

参考文档http://www.javawind.net/help/html/jstl_el.htm