您的位置：首页 > 编程语言 > Java开发

JavaWeb开发第8章标准标签库(JSTL)之三国际化标签

2012-11-30 15:52 399 查看

8.4国际化标签

8.4.1 国际化标签库概述

为了简化WEB应用的国际化开发，JSTL中提供了一个用于实现国际化和格式化功能的标签库，我们将其简称为国际化标签库，JSP规范为国际化标签库建议的前缀名为fmt。国际化标签库中包括了一组用于实现WEB国际化功能的标签，这组标签封装了Java语言中java.util和java.text这两个包中与国际化相关的API类的功能。国际化标签库中提供了绑定资源包和从资源包中的本地资源文件内读取文本内容的标签，也提供了对数值和日期等本地敏感的数据按本地化信息进行显示和解析的标签，还提供了按本地特定的时区来调整时间的标签。
国际化标签库中的标签可以根据客户端浏览器的信息来自动确定本地信息，也可以由JSP页面作者显式地指定本地信息。如果没有特别指定，本章案例假设默认的本地信息为“中文（中国）”。
在举例讲解国际化标签库中的标签时， 通常要使用到包含有多个资源文件的资源包，这个资源包中的各个资源文件分别对应几个不同本地信息。这里先创建好一组资源包文件。首先按例程8-25和例程8-26创建两个名称分别为greetings.properties和temp.properties的资源文件。
例程8-25greetings.properties

org.it315.heading=Thefirst WEB application
org.it315.welcome=Welcometo www.it315.org !
org.it315.okKey=Todayis {0,date,full}, you have {1,number,currency} dollars.

例程8-26temp.properties

org.it315.heading=第一个WEB应用程序
org.it315.welcome=欢迎访问www.it315.org网站!
org.it315.okKey=今天是{0,date,full}，你有{1,number,currency}元。

接着使用JDK中提供的native2ascii程序将temp.properties文件中的中文字符转换成其Unicode码形式的转义序列。在命令行窗口中进入temp.properties文件所在的目录，执行如下命令：
native2ascii -encoding GB2312temp.properties greetings_zh.properties
上面的命令执行后产生的greetings_zh.properties文件内容如例程8-27所示。
例程8-27greetings_zh.properties

org.it315.heading=\u7b2c\u4e00\u4e2aWEB\u5e94\u7528\u7a0b\u5e8f
org.it315.welcome=\u6b22\u8fce\u8bbf\u95eewww.it315.org\u7f51\u7ad9!
org.it315.okKey=\u4eca\u5929\u662f{0,date,full}\uff0c\u4f60\u6709{1,number,
currency}\u5143\u3002

英文本地环境所对应的资源文件只需复制greetings.properties文件，并改名为greetings_en.properties即可。最后将greetings.properties、greetings_en.properties和greetings_zh.properties这三个资源文件保存到<TOMCAT_HOME>\webapps\JSTL\WEB-INF\classes\org\it315\目录中。

8.4.2 <fmt:setLocale>标签

<fmt:setLocale>标签用于在JSP页面中显式地设置用户的本地化信息，并将设置的本地化信息以Locale对象的形式保存在某个Web域中，其在Web域中的属性名称为“javax.servlet.jsp.jstl.fmt.locale”。使用<fmt:setLocale>标签设置本地化信息后，国际化标签库中的其他标签将使用该本地化信息，而忽略客户端浏览器传递过来的本地信息。<fmt:setLocale>标签的语法格式如下：
<fmt:setLocalevalue="locale"

[variant="variant"]

[scope="{page|request|session|application}"]/>
<fmt:setLocale>标签的属性说明如表8.12所示。
表8.12
<fmt:setLocale>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
value

true

String或java.util.Locale

指定用户的本地化信息，可以是一个字符串或java.util.Locale实例对象。如果是字符串，则必须包含小写形式的语言编码，其后也可以带有大写形式的国家编码，两者中间用“-”或“_”连接

variant

true

String

指定创建Locale实例对象时设置的变量部分，它用于标识开发商或特定浏览器为实现扩展功能而自定义的信息

scope

false

String

指定将构造出的Locale实例对象保存在哪个Web作用域中

如果<fmt:setLocale>标签的value属性值为null，<fmt:setLocale>标签将采用客户端浏览器传递过来的本地信息。例程8-28是一个使用<fmt:setLocale>标签的例子程序。
例程8-28fmt_setLocale.jsp

<%@ taglibprefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ pagecontentType="text/html;charset=gb2312" %>
<fmt:setLocalevalue="${param.locale}" />
<fmt:setBundlebasename="org.it315.greetings" var="greetings" />
<head>
<title><fmt:messagebundle="${greetings}" key="org.it315.heading"/></title>
</head>
<jsp:useBeanid="now" class="java.util.Date" />
<%
session.setAttribute("number",new Integer(8888888));
%>
<fmt:messagebundle="${greetings}" key="org.it315.welcome" /><br/>
<fmt:messagebundle="${greetings}" key="org.it315.okKey">
<fmt:param value="${now}"/>
<fmt:param value="${number}"/>
</fmt:message>

例程8-28中的<fmt:setBundle>标签用于根据<fmt:setLocale>标签设置的本地化信息绑定一个资源包，其细节请参看8.4.3节；<fmt:message>标签用于从一个资源包中读取信息并进行格式化输出，其细节请参看8.4.5节；<fmt:param>标签用于为格式化文本串中的占位符设置参数值，其细节请参看8.4.6节。
在浏览器地址栏输入如下地址访问fmt_setLocale.jsp页面：
http://localhost:8080/JSTL/fmt_setLocale.jsp?locale=en_US
例程8-28的运行结果如图8.22所示。



将上面的访问地址中的locale参数设置为zh_CN后访问fmt_setLocale.jsp页面，例程8-28的运行结果如图8.23所示。



8.4.3 <fmt:setBundle>标签

<fmt:setBundle>标签用于根据<fmt:setLocale>标签设置的本地化信息创建一个资源包（ResourceBundle）实例对象，并将其绑定到一个Web域的属性上。<fmt:setBundle>标签的语法格式如下：
<fmt:setBundle basename="basename"
[var="varName"]
[scope="{page|request|session|application}"] />
<fmt:setBundle>标签的属性说明如表8.13所示。
表8.13 <fmt:setBundle>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
basename

true

String
指定创建ResourceBundle实例对象的基名

var

false

String
指定将创建出的ResourceBundle实例对象保存到Web域中的属性名称

scope

false

String
指定将创建出的ResourceBundle实例对象保存在哪个Web作用域中

<fmt:setBundle>标签有如下一些特性：
（1）如果basename属性的值为null或空字符串，或找不到basename属性指定的资源，<fmt:setBundle>标签保存到Web域中的属性的值为null。
（2）如果指定了var属性，<fmt:setBundle>标签将把ResourceBundle实例对象以var属性的值作为域属性名称保存到Web域中。
（3）如果没有指定var属性，<fmt:setBundle>标签将把ResourceBundle实例对象以域属性名javax.servlet.jsp.jstl.fmt.localizationContext保存到Web域中。所有没有嵌套在<fmt:bundle>标签中且未指定bundle属性的<fmt:formatDate>都将使用该标签创建的资源包。
在前面的例程8-28中已经使用了<fmt:setBundle>标签，这里就不再对<fmt:setBundle>标签进行举例讲解了。

8.4.4 <fmt:bundle>标签

<fmt:bundle>标签与<fmt:setBundle>标签的功能类似，但它创建的ResourceBundle实例对象只在其标签体内有效。<fmt:bundle>标签的语法格式如下：
<fmt:bundle basename="basename"
[prefix="prefix"]>
body content
</fmt:bundle>
<fmt:bundle>标签的属性说明如表8.14所示。
表8.14 <fmt:bundle>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
basename

true

String
指定创建ResourceBundle实例对象的基名

prefix

true

String
指定追加到嵌套在<fmt:bundle>标签内的<fmt:message>标签的key属性值前面的前缀

如果设置了<fmt:bundle>标签的prefix属性，则其中嵌套的<fmt:message>标签的key属性值中就可以省略prefix属性设置的前缀部分，这对要使用具有相同前缀的多个关键字的情况提供了一些简便。
例程8-29是一个使用<fmt:bundle>标签的例子程序，其中分别演示了设置和不设置prefix属性的情况。
例程8-29fmt_bundle.jsp
<%@ taglibprefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ pagecontentType="text/html;charset=gb2312" %>
没有设置prefix属性的情况:<br />
<fmt:bundlebasename="org.it315.greetings">
<fmt:messagekey="org.it315.heading" /><br />
<fmt:message key="org.it315.welcome"/><br /><hr />
</fmt:bundle>
设置prefix属性的情况:<br />
<fmt:bundlebasename="org.it315.greetings" prefix="org.it315.">
<fmt:message key="heading"/><br />
<fmt:message key="welcome"/>
</fmt:bundle>

例程8-29的运行结果如图8.24所示。



8.4.5 <fmt:message>标签

<fmt:message>标签用于从一个资源包中读取信息并进行格式化输出，它有如下一些使用语法格式：
语法1，没有标签体的情况：
<fmt:message key="messageKey"

[bundle="resourceBundle"]
[var="varName"]
[scope="{page|request|session|application}"]/>
语法2，在标签体中指定格式化文本串中的占位符参数的情况：
<fmt:message key="messageKey"
[bundle="resourceBundle"]
[var="varName"]
[scope="{page|request|session|application}"]>
<fmt:param>subtags
</fmt:message>
语法3，在标签体中指定消息关键字和可选择的占位符参数：
<fmt:message [bundle="resourceBundle"]
[var="varName"]
[scope="{page|request|session|application}"]>
key
optional<fmt:param>subtags
</fmt:message>
<fmt:message>标签的属性说明如表8.15所示。
表8.15 <fmt:message>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
key

true

String

指定要输出的信息的关键字

bundle

true

LocalizationContext

指定ResourceBundle对象在Web域中的属性名称

var

false

String

用于指定将格式化结果保存到某个Web域中的某个属性的名称

scope

false

String

指定将格式化结果保存到哪个Web域中

<fmt:message>标签有如下一些特性：
l 如果指定的资源不存在，输出“???<key>???”形式的错误信息。
l 如果ResouceBundle中不存在key属性指定的信息，输出“???<key>???”形式的错误信息。
l 如果key属性的值为null或空字符串，输出“??????”形式的错误信息。
l 如果没有指定var属性，<fmt:message>标签将直接输出格式化的结果；如果指定了var属性，则<fmt:message>标签将格式化的结果保存在scope属性指定的Web域中，保存在Web域中的属性名称为var属性指定的值。如果指定了scope属性，就必须指定var属性。
l 要输出的消息的关键字可以使用key属性指定，也可以在标签体中指定。如果<fmt:message>标签嵌套在<fmt:bundle>标签内，并且<fmt:bundle>标签设置了prefix属性，则该属性的值追加到<fmt:message>标签指定的关键字的前面。
l 可以通过在<fmt:message>标签内嵌套<fmt:param>标签来指定格式化文本串中的占位符的参数值，每个<fmt:param>标签分别设置一个参数，各个<fmt:param>标签的顺序与格式化字符串的参数相对应，即第一个<fmt:param>标签对应于格式化字符串中的第一个参数，第二个<fmt:param>对应于格式化字符串中的第二个参数，依次类推。
l 如果<fmt:message>标签处理的格式化文本串中包含有参数，但其中没有嵌套与该参数对应<fmt:param>标签，则直接输出该参数在格式化文本串中的原始形式。

例程8-30是一个使用<fmt:message>标签的例子程序。
例程8-30 fmt_message.jsp

<%@ taglibprefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ pagecontentType="text/html;charset=gb2312" %>
<jsp:useBeanid="now" class="java.util.Date" />
<%
session.setAttribute("number",new Integer(8888888));
%>
<fmt:setBundlebasename="org.it315.greetings" var="greetings" />
<fmt:message>标签内嵌套<fmt:param>标签的情况：<br
/>
<fmt:messagebundle="${greetings}">
org.it315.okKey
<fmt:param value="${now}"/>
<fmt:param value="${number}"/>
</fmt:message><br/><hr />
<fmt:message>标签内没有嵌套<fmt:param>标签的情况：<br
/>
<fmt:bundlebasename="org.it315.greetings" prefix="org.it315.">
<fmt:message key="okKey"/>
</fmt:bundle>

例程8-30的运行结果如图8.25 所示。



8.4.6 <fmt:param>标签

<fmt:param>标签用于为格式化文本串中的占位符设置参数值，它只能嵌套在<fmt:message>标签内使用。<fmt:param>标签有如下两种语法格式：
语法1，用value属性指定参数值：
<fmt:param value="messageParameter" />
语法2，在标签体中指定参数的值的情况：
<fmt:param>
body content
</fmt:param>
说明：<fmt:param>标签的value属性的类型是java.lang.Object，它支持动态属性值。在前面的例程中已经多次使用了<fmt:param>标签，这里就不再对<fmt:param>标签进行举例讲解了。

8.4.7 <fmt:requestEncoding>标签

<fmt:requestEncoding>标签用于设置请求消息的字符集编码，该标签内部调用request.setCharacterEncoding()方法，以便Web容器将请求消息中的参数值按该字符集编码转换成Unicode字符串返回。<fmt:requestEncoding>标签的语法格式如下：
<fmt:requestEncoding[value="charsetName" />
其中的value属性用于指定请求消息的字符集编码，其类型为String，支持动态属性值。
关于<fmt:requestEncoding>标签的几点说明：
（1）为了能够正确解码请求参数值中的非ISO-8859-1编码的字符，应该调用这个标签来设置请求消息的字符集编码，并且必须在获取任何请求参数（包括使用EL表达式获取参数）之前进行调用。
（2）因为很多浏览器没有完全遵守HTTP规范，在请求消息中没有包含Content-Type请求头，所以使用这个标签来设置请求消息的字符集编码是很有必要的。
（3）<fmt:requestEncoding>标签的value属性的设置值通常为提交这次请求的页面的字符集编码，如果不能预先确定请求消息的字符集编码，那就不应指定value属性。如果没有设置<fmt:requestEncoding>标签的value属性，<fmt:requestEncoding>标签首先采用请求消息的Content-Type头中定义的字符集编码，如果不能从请求消息的Content-Type头中确定字符集编码，则采用session域中的javax.servlet.jsp.jstl.fmt.request.charset属性的值，否则，采用ISO-8859-1字符集编码。
例程8-31是一个使用<fmt:requestEncoding>标签的例子程序。
例程8-31 fmt_requestEncoding.jsp

<%@ taglibprefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ pagecontentType="text/html;charset=gb2312" %>
<fmt:requestEncodingvalue="gb2312" />

我最喜欢的科目是:${param.favourite}<br/>
<formmethod="POST">

你最喜欢学习的是什么科目?<br />

<inputtype="text" name="favourite" />

<input type="submit" value="OK"/><br/>
</form>

例程8-31的运行结果如图8.26所示，在文本框中输入“英语”，单击其中的OK按钮后的运行结果如图8.27所示。





8.4.8 <fmt:timeZone>标签

<fmt:timeZone>标签用于设置时区，但它的设置值只对其标签体部分有效。<fmt:timeZone>标签标签的语法格式如下：
<fmt:timeZonevalue="timeZone">
bodycontent
</fmt:timeZone>
其中的value属性支持动态属性值，它的值可以是一个命名时区的字符串，也可以是java.util.TimeZone类的一个实例对象。如果value属性的值为null或空字符串，标签体中的内容就使用GMT的0基准时区。如果value属性的值是表示时区名称的字符串，这个字符串通过java.util.TimeZone.getTimeZone()静态方法被解析为java.util.TimeZone类的实例对象。
例程8-32是一个使用<fmt:timeZone>标签的例子程序。
例程8-32 fmt_timeZone.jsp

<%@ taglib prefix="fmt"uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.TimeZone" %>
<jsp:useBean id="now" class="java.util.Date"/>
使用“GMT+1:00”时区：<br />
<fmt:timeZone value="GMT+1:00">
<fmt:formatDatevalue="${now}" type="both" dateStyle="full"timeStyle="full"/>
</fmt:timeZone><br /><hr />
<%
TimeZone tz =TimeZone.getDefault();
pageContext.setAttribute("tz",tz);
%>
使用默认的时区，value为java.util.TimeZone的一个实例：<br
/>
<fmt:timeZone value="${tz}">
<fmt:formatDatevalue="${now}" type="both" dateStyle="full"timeStyle="full"/>
</fmt:timeZone><br /><hr />
使用“America/Los_Angeles”时区：<br />
<fmt:timeZone value="America/Los_Angeles">
<fmt:formatDatevalue="${now}" type="both" dateStyle="full"timeStyle="full"/>
</fmt:timeZone>

例程8-32的运行结果如图8.28所示。



8.4.9 <fmt:setTimeZone>

<fmt:setTimeZone>标签用于在JSP页面中显示地设置时区，并将设置的时区信息以TimeZone对象的形式保存在某个Web域中，其在Web域中的属性名称为javax.servlet.jsp.jstl.fmt.timeZone。<fmt:setTimeZone>标签的语法格式如下：
<fmt:setTimeZonevalue="timeZone"
[var="varName"]
[scope="{page|request|session|application}"]/>
<fmt:setTimeZone>标签的属性说明如表8.16所示。
表8.16 <fmt:setTimeZone>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
value

true

String或java.util.TimeZone

指定表示时区的ID字符串或TimeZone对象

var

false

String

指定将创建出的TimeZone实例对象保存到Web域中的属性名称

scope

false

String

指定将创建出的TimeZone实例对象保存到哪个Web域中

其中，value属性的设置值的细节与<fmt:timeZone>标签的细节相同；<fmt:setTimeZone>标签将创建出的TimeZone实例对象保存在scope属性指定的Web域中，如果指定了var属性，保存在Web域中的属性名称为var属性指定的值，否则，保存在Web域中的属性名称为javax.servlet.jsp.jstl.fmt.timeZone，所有没有嵌套在其他<fmt:timeZone>标签中且未指定timezone属性的<fmt:formatDate>标签都将使用该域属性名关联的时区。
例程8-33是一个使用<fmt:setTimeZone>标签的例子程序。
例程8-33 fmt_setTimeZone.jsp

<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt"%>
<%@ page contentType="text/html;charset=gb2312" %>
<jsp:useBean id="now" class="java.util.Date"/>
<fmt:setTimeZone value="America/Los_Angeles"/>
“America/Los_Angeles”时区的现在时间是:<br />
<fmt:formatDate value="${now}" type="both"/><hr />
“GMT+1:00”时区的现在时间是:<br />
<fmt:timeZone value="GMT+1:00">
<fmt:formatDatevalue="${now}" type="both" />
</fmt:timeZone>

例程8-33的运行结果如图8.29所示。



8.4.10 <fmt:formatDate>标签

<fmt:formatDate>标签用于对日期和时间按本地化信息进行格式化，或对日期和时间按化为JSP页面作者自定义的格式进行格式化。<fmt:formatDate>标签的语法格式如下：
<fmt:formatDatevalue="date"

[type="{time|date|both}"]

[dateStyle="{default|short|medium|long|full}"]

[timeStyle="{default|short|medium|long|full}"]

[pattern="customPattern"]

[timeZone="timeZone"]

[var="varName"]

[scope="{page|request|session|application}"]/>
<fmt:formatDate>标签的属性说明如表8.17所示。
表8.17<fmt:formatDate>标签的属性
属性名
是否支持EL
属性类型
属 性 描 述
value

true

java.util.Date

指定要格式化的日期或时间

type

true

String

指定是格式化输出日期部分，还是格式化输出时间部分，还是两者都输出

dateStyle

true

String

指定日期部分的输出格式，其可用的设置值可以参照java.text.DateFormat类的讲解。该属性仅在type属性取值为date或both时才有效

timeStyle

true

String

指定时间部分的输出格式，其可用的设置值请参照java.text.DateFormat类的讲解。该属性仅在type属性取值为time或both时才有效

pattern

true

String

指定一个自定义的日期和时间输出格式

timeZone

true

String或java.util.timeZone

指定当前采用的时区

var

false

String

用于指定将格式化结果保存到某个Web域中的某个属性的名称

scope

false

String

指定将格式化结果保存到哪个Web域中

<fmt:formatDate>标签有如下一些特性：
l 如果没有指定var属性，<fmt: formatDate>标签将直接输出格式化的结果；如果指定了var属性，则<fmt:formatDate>标签将格式化的结果保存在scope属性指定的Web域中，保存在Web域中的属性名称为var属性指定的值。如果指定了scope属性，就必须指定var属性。
l 如果value属性的值为null，则不输出任何内容，如果这时候指定了var和scope属性，将scope属性指定的Web域中的var属性指定的域属性删除。
l JSP网页作者可以使用pattern属性设置自定义的日期格式，这时候，<fmt:formatDate>标签将忽略type、dateStyle和timeStyle等属性。pattern属性的值必须符合java.text.SimpleDateFormat类的日期模式的语法。
l 如果timeZone属性的值为null或者空字符串，相当于没有设置这个属性。
l 如果要格式化一个表示日期或时间的字符串，必须首先用<fmt:parseDate>标签将其解析为java.util.Date类的一个实例对象，再使用<fmt:formatDate >标签对这个Date实例对象进行格式化。<fmt:parseDate>标签的介绍请参看8.4.11节。
l 如果<fmt:formatDate>标签不能确定格式化的本地化信息，就使用java.util.Date.toString()方法作为输出格式。
例程8-34是一个使用<fmt:formatDate>标签的例子程序。
例程8-34 fmt_formatDate.jsp

<%@ taglib prefix="fmt"uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<%@ page import="java.util.TimeZone" %>
<jsp:useBean id="now" class="java.util.Date"/>
格式化当前日期、时间：
<fmt:formatDate value="${now}" type="both"timeStyle="medium" dateStyle="long"/>
<hr/>
<%
session.setAttribute("tz",TimeZone.getTimeZone("GMT+10"));
%>
指定时区为“GMT+10”：
<fmt:formatDate value="${now}" type="both"timeZone="${tz}" /><hr />
指定自定义的格式，月.日.年:
<fmt:formatDate value="${now}"pattern="MM.dd.yyyy" /><hr />
格式化用字符串表示的日期：
<fmt:parseDate value="7/31/05"pattern="MM/dd/yy" var="parsed" />
<fmt:formatDate value="${parsed}" />

例程8-34的运行结果如图8.30
所示。



8.4.11 <fmt:parseDate>标签

<fmt:parseDate>标签与<fmt: formatDate>标签的作用正好相反，它用于将一个表示日期和时间的字符串解析成java.util.Date实例对象，它有如下两种语法格式：
语法1，没有标签体的情况：
<fmt:parseDate value="dateString"
[type="time|date|both"]
[dateStyle="default|short|medium|long|full"]
[timeStyle="default|short|medium|long|full"]
[pattern="customPattern"]
[timeZone="timeZone"]
[parseLocale="parseLocale"]
[var="varName"]
[scope="{page|request|session|application}"]/>
语法2， 有标签体的情况，在标签体中指定要被解析的日期和/或时间值：
<fmt:parseDate [type="time|date|both"]
[dateStyle="default|short|medium|long|full"]
[timeStyle="default|short|medium|long|full"]
[pattern="customPattern"]
[timeZone="timeZone"]
[parseLocale="parseLocale"]
[var="varName"]
[scope="{page|request|session|application}"]>
date value to be parsed
</fmt:parseDate>
<fmt:parseDate>标签的属性说明如表8.18所示。
表8.18 <fmt:parseDate>标签的属性
表8.18 <fmt:parseDate>标签的属性
<fmt:parseDate>标签有如下一些特性：
l value属性的值必须是合法的日期/时间字符串，否则<fmt:parseDate>标签在解析时抛出异常。如果value属性的值为null或空字符串，就删除scope属性指定的域范围中的var属性命名的变量。
l 根据type属性的值，要解析日期字符串可以包含日期、时间或同时包含日期和时间，并根据指定的格式类型进行解析。
l 如果timeZone属性的值为null或空字符串，按没有设置这个属性处理。
l 如果parseLocale属性的值为null或空字符串，按没有设置该属性处理。
l 如果指定pattern属性，标签就忽略它的type、dateStyle和timeStyle属性。这时，根据pattern属性设置的自定义格式解析value属性指定的日期和/或时间字符串，所以，要解析的日期和/或时间字符串必须严格符合pattern属性设置的自定义格式。pattern属性的值必须符合java.text.SimpleDateFormat类的模式语法。
l 如果标签不能确定解析的本地环境，就抛出JspException异常，异常信息中包含要解析的字符串。

在前面的例程8-34中已经使用了<fmt:parseDate>标签，这里就不再对<fmt:parseDate>标签进行举例讲解了。

8.4.12 <fmt:formatNumber>标签

<fmt:formatNumber>标签用于将数值、货币或百分数按本地化信息进行格式化，或者按JSP页面作者自定义的格式进行格式化。<fmt:formatNumber>标签有两种语法格式：
语法1，没有标签体的情况：
<fmt:formatNumbervalue="numericValue"
[type="{number|currency|percent}"]
[pattern="customPattern"]
[currencyCode="currencyCode"]
[currencySymbol="currencySymbol"]
[groupingUsed="{true|false}"]
[maxIntegerDigits="maxIntegerDigits"]
[minIntegerDigits="minIntegerDigits"]
[maxFractionDigits="maxFractionDigits"]
[minFractionDigits="minFractionDigits"]
[var="varName"]
[scope="{page|request|session|application}"]/>
语法2，有标签体的情况，在标签体中指定要被格式化的数值：
<fmt:formatNumber[type="{number|currency|percent}"]
[pattern="customPattern"]
[currencyCode="currencyCode"]
[currencySymbol="currencySymbol"]
[groupingUsed="{true|false}"]
[maxIntegerDigits="maxIntegerDigits"]
[minIntegerDigits="minIntegerDigits"]
[maxFractionDigits="maxFractionDigits"]
[minFractionDigits="minFractionDigits"]
[var="varName"]
[scope="{page|request|session|application}"]>
要被格式化的数值
</fmt:formatNumber>
如果指定scope属性，就必须指定var属性。<fmt:formatNumber>标签的属性说明如表8.19所示。
表8.19 <fmt:formatNumber>标签的属性
<fmt:formatNumber>标签有如下一些特性：
l 如果value属性的值为null，则不输出任何内容，如果这时候指定了var和scope属性，将scope属性指定的Web域中的var属性指定的域属性删除。
l pattern属性优先于type属性，不管是使用哪个属性，格式化的标记（例如十进制小数的整数部分、小数部分的分隔符及组分隔符）通过格式化的Locale特性来决定。
l pattern属性指定的模式字符串必须符合java.text.DecimalFormat类的模式语法。如果pattern属性为null或空字符串，就相当于没有设置这个属性的值。
l currencyCode属性的值必须是一个合法的ISO 4217货币编码。
l groupingUsed属性指定是否要将格式化后的数值的整数部分的数字分组。例如，在英语本地环境中，将比较大的数值按每三个数字分为一组，每组用逗号定界，其它的本地环境可能用点或空格来定界这样的分组。详细信息参考java.text.NumberFormat类的setGroupingUsed()方法。
l 当type属性的值为currency时，currencyCode属性用来显式地指定要显示的数据的货币符号。currencySymbol属性也可以显式地指定货币符号。当WEB容器的运行环境是JDK1.4或更高版本时，如果同时指定<fmt:formatNumber>标签的currencyCode和currencySymbol属性，前者优先于后者；但当WEB容器的运行环境是JDK1.4以前的版本时，currencySymbol属性优先于currencyCode属性。
l 如果<fmt:formatNumber>标签不能确定格式化的本地环境，就使用Number.toString()作为输出格式。
例程8-35是一个使用<fmt:formatNumber>标签的例子程序。
例程8-35
fmt_formatNumber.jsp

<%@ taglib prefix="fmt"uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312"%>
<%@ pageimport="java.util.Currency,java.util.Locale"%>
将数值格式化为货币格式：
<fmt:formatNumbervalue="9876543.21" type="currency" /><hr />
将数值格式化为百分数格式：
<fmt:formatNumber value="12.3"type="percent" /><hr />
将数值格式化为自定义的格式：
<fmt:formatNumber value="12.3"pattern=".000" />；
<fmt:formatNumbervalue="123456.7891" pattern="#,#00.0#" /><hr />
<%
Stringcode = Currency.getInstance(Locale.CHINA).getCurrencyCode();
String symbol =Currency.getInstance(Locale.US).getSymbol();
session.setAttribute("code",code);
session.setAttribute("symbol",symbol);
%>
同时指定currencyCode和currencySymbol属性，前者优先于后者：
<fmt:formatNumbervalue="1234567.11" type="currency"currencyCode="${code}"

currencySymbol="${symbol}"/>

例程8-35的运行结果如图8.31
所示。



8.4.13 <fmt:parseNumber>标签

<fmt:parseDate>标签与<fmt: formatNumber>标签的作用正好相反，它用于将一个按本地化方式被格式化后的数值、货币或百分数解析为数值，它有如下两种语法格式：

语法1，没有标签体的情况：

<fmt:parseNumbervalue="numericValue"

[type="{number|currency|percent}"]

[pattern="customPattern"]

[parseLocale="parseLocale"]

[integerOnly="{true|false}"]

[var="varName"]

[scope="{page|request|session|application}"]/>

语法2，有标签体的情况，在标签体中指定要被解析的数值：

<fmt:parseNumber[type="{number|currency|percent}"]

[pattern="customPattern"]

[parseLocale="parseLocale"]

[integerOnly="{true|false}"]

[var="varName"]

[scope="{page|request|session|application}"]>

numeric value to be parsed

</fmt:parseNumber>

<fmt:parseNumber>标签的属性说明如表8.20所示。

表8.20 <fmt:parseNumber>标签的属性

<fmt:parseNumber>标签有如下一些特性：

l 如果value属性的值为null或空字符串，则将scope属性指定的Web域中的var属性指定的域属性删除。如果value属性的值不能解析为数值就抛出异常。

l pattern属性指定的模式字符串必须符合java.text.DecimalFormat类的模式语法。如果其值为null或空字符串，就相当于没有设置这个属性的值。使用<fmt:parseNumber>解析值时要特别注意，它执行的解析非常严格，要解析的数值字符串必须严格符合特定的本地环境及pattern属性设置的自定义格式。

l 如果parseLocale属性的值为null或空字符串，就相当于没有指定该属性。

l integerOnly属性指定是否只是解析value的整数部分。详细信息请看java.text.NumberFormat接口的setParseIntegerOnly()方法。

l 如果同时指定type属性和pattern属性，后者优先权高于前者。

l 如果设置了var属性，将解析的结果保存在某个Web域中的var属性指定的域属性中；否则，<fmt:parseNumber>将使用java.lang.Number.toString()直接输出解析的结果。如果指定scope属性，则必须指定var属性。

l 如果标签不能确定解析的本地环境，就抛出JspException异常，异常信息中包含要解析的字符串。

例程8-36是一个使用<fmt:parseNumber>标签的例子程序。

例程8-36 fmt_parseNumber.jsp

<%@ taglib prefix="fmt"uri="http://java.sun.com/jsp/jstl/fmt" %>

<%@ page contentType="text/html;charset=gb2312" %>

本地环境为“en_US”解析字符串“$123,456,789.00”：

<fmt:parseNumber value="$123,456,789.00"type="currency" parseLocale="en_US"/>

<hr/>

解析整个数值字符串“123,456,789%”：

<fmt:parseNumber value="123,456,789%"type="percent" /><hr />

只解析“123,456,789%”的整数部分：

<fmt:parseNumber value="123,456,789%" type="percent"integerOnly="true"/><hr />

同时设置type和pattern属性，后者优先于前者：

<fmt:parseNumber value="12.3" type="currency"pattern=".000" />

例程8-36的运行结果如图8.32
所示。




注意：在分层设计的软件架构中，JSP页面通常仅用于实现系统的表示层，数据解析的任务不适合在表示层进行处理，而最好是业务逻辑层进行处理，所以，为了增强软件的易维护性和可扩展性，读者应尽量避免在JSP 页面中使用<fmt:parseDate>和<fmt:parseNumber>标签。

好了，就介绍到这里吧！

内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签： 
相关文章推荐
新的分享
章节导航