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-25 greetings.properties
org.it315.heading=The first WEB application
org.it315.welcome=Welcome to www.it315.org !
org.it315.okKey=Today is {0,date,full}, you have {1,number,currency} dollars.
例程8-26 temp.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 GB2312 temp.properties greetings_zh.properties
上面的命令执行后产生的greetings_zh.properties文件内容如例程8-27所示。
例程8-27 greetings_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:setLocale value="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-28 fmt_setLocale.jsp
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
<fmt:setLocale value="${param.locale}" />
<fmt:setBundle basename="org.it315.greetings" var="greetings" />
<head>
<title><fmt:message bundle="${greetings}" key="org.it315.heading" /></title>
</head>
<jsp:useBean id="now" class="java.util.Date" />
<%
session.setAttribute("number", new Integer(8888888));
%>
<fmt:message bundle="${greetings}" key="org.it315.welcome" /><br />
<fmt:message bundle="${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所示。
图8.22
将上面的访问地址中的locale参数设置为zh_CN后访问fmt_setLocale.jsp页面,例程8-28的运行结果如图8.23所示。
图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-29 fmt_bundle.jsp
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>
<%@ page contentType="text/html;charset=gb2312" %>
没有设置prefix属性的情况:<br />
<fmt:bundle basename="org.it315.greetings">
<fmt:message key="org.it315.heading" /><br />
<fmt:message key="org.it315.welcome" /><br /><hr />
</fmt:bundle>
设置prefix属性的情况:<br />
<fmt:bundle basename="org.it315.greetings" prefix="org.it315.">
<fmt:message key="heading" /><br />
<fmt:message key="welcome" />
</fmt:bundle>
例程8-29的运行结果如图8.24所示。
图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
<%@ 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" />
<%
session.setAttribute("number", new Integer(8888888));
%>
<fmt:setBundle basename="org.it315.greetings" var="greetings" />
<fmt:message>标签内嵌套<fmt:param>标签的情况:<br />
<fmt:message bundle="${greetings}">
org.it315.okKey
<fmt:param value="${now}" />
<fmt:param value="${number}" />
</fmt:message><br /><hr />
<fmt:message>标签内没有嵌套<fmt:param>标签的情况:<br />
<fmt:bundle basename="org.it315.greetings" prefix="org.it315.">
<fmt:message key="okKey" />
</fmt:bundle>
例程8-30的运行结果如图8.25 所示。
图8.25