 | 级别： 初级 翟斌(David Zhai) (zhaibin@yahoo.com),
2002 年 8 月 20 日 本文对JSP国际化的简要介绍,着重探讨了使用标记库对JSP进行国际化的过程,并通过详细的示例演示了如何使用jakarta的i18n标记库。
综述
当我们在用JSP设计面对不同国家的站点时,特别是那些在界面之间没有特别大差别的商业站点,我们可以利用JSP的一些机制来支持国际化.
通常有三种方式可以实现国际化.
- 为每个国家编写一套JSP代码, 可以通过嵌入BEAN和标记处理器的方式重用一些逻辑代码.
- 维护统一的JSP代码,直接利用JAVA的资源捆绑机制实现国际化.
- 维护统一的JSP代码,利用通用的或自定义标记库实现国际化.
我们重点讨论第三种方法,因为它有很好的灵活性,可维护性和可扩展性.
其实标记库也是利用JAVA的资源捆绑机制, 只是把国际化常用的方法封装的更容易使用,而且更符合JSP的编程思想, 把表述层和逻辑层分开.通用的标记库比较著名的有JAKARTA的I18N标记库。本文接着上一篇继续讨论i18n标记库的各种标记和使用方法，包括以下内容：
- 对时间,日期,货币,数字国际化
- I18N标记库的一些高级用法
- 一个简单的例子
对时间,日期,货币,数字国际化
formatString
输出一个字符串，如果value为空则显示defaultText
<i18n:formatString value="<%= s2 %>" defaultText="the String was null"/>
|
表1:formatString的属性描述
| 属性名称 | 描述 | | id | 该formatString的标识变量, 通过它,其他标记和代码可以访问该formatString, | | value | 输出的字符串 | | defaultText | 默认的输出字符串 |
formatNumber
根据locale信息国际化数字，它的pattern可以定义为‘##,###.##’。如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatNumber value="<%= n %>" pattern="##,###,###.##"/>
|
表2:formatNumber的属性描述
| 属性名称 | 描述 | | id | 该formatNumber的标识变量, 通过它,其他标记和代码可以访问该formatNumber | | value | 输出的数字 | | pattern | 输出的模式（##,###.##） | | locale | locale信息 | | defaultText | 默认的输出数字 |
formatCurrency
根据locale信息国际化货币。如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatCurrency value="<%= n %>"/>
|
表3:formatCurrency的属性描述
| 属性名称 | 描述 | | id | 该formatCurrency的标识变量, 通过它,其他标记和代码可以访问该formatCurrency | | value | 输出的货币值 | | locale | locale信息 | | defaultText | 默认的输出货币值 |
formatPercent
根据locale信息国际化百分数。如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatPercent value="<%= n %>"/>
|
表4:formatPercent的属性描述
| 属性名称 | 描述 | | id | 该formatPercent的标识变量, 通过它,其他标记和代码可以访问该formatPercent | | value | 输出的百分数 | | locale | locale信息 | | defaultText | 默认的输出百分数 |
formatDateTime
根据locale信息国际化日期时间。它的dateStyle和timeStyle可以定义为'short/medium/long/full'如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatDateTime dateStyle="medium" timeStyle="medium"/>
|
表5:formatDateTime的属性描述
| 属性名称 | 描述 | | id | 该formatDateTime的标识变量, 通过它,其他标记和代码可以访问该formatDateTime | | value | 输出的日期时间 | | locale | 指定的locale信息 | | dateStyle | 输出的日期格式 | | timeStyle | 输出的时间格式 | | defaultText | 默认的输出日期和时间 |
formatDate
根据locale信息国际化日期。它的style可以定义为（short/medium/long/full),pattern可定义为'YYYY MMM ddd'.如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatDate pattern="yyyy MMMMM ddd hh:mm:ss"/>
|
表6:formatDate的属性描述
| 属性名称 | 描述 | | id | 该formatDate的标识变量, 通过它,其他标记和代码可以访问该formatDate | | value | 输出的日期 | | locale | 指定的locale信息 | | pattern | 日期的模式(YYYY MMM ddd) | | Style | 日期的格式(short/medium/long/full) | | defaultText | 默认的输出日期 |
formatTime
根据locale信息国际化日期。它的style可以定义为（short/medium/long/full).如果value为空则显示defaultText，如果不设locale，则取上一级的<i18n:locale>的设定，如果没有<i18n:locale>，则根据客户端请求的locale，如果还是没有发现，则取本地JVM的locale。
<i18n:formatTime style="full"/>
|
表7:formatTime的属性描述
| 属性名称 | 描述 | | id | 该formatTime的标识变量, 通过它,其他标记和代码可以访问该formatTime | | value | 输出的时间 | | locale | 指定的locale信息 | | Style | 日期的格式(short/medium/long/full) | | defaultText | 默认的输出日期 |
I18N标记库的一些高级用法
ifdef
判断一个key是否存在于指定(或默认)的资源文件中,如果存在则进行该标记中的语句.
<i18n:ifdef key="zh_CN_ONLY">
Only users specifying zh_CN as their locale will see this!
</i18n:ifdef>
|
表8:ifdef的属性描述
| 属性名称 | 描述 | | key | 欲判断是否在资源文件中的key的名字 | | bundle | ResourceBundle的基本名,可以连同locale信息定位所需的ResourceBundle. | | bundleRef | 一个包含ResourceBundle的属性名,通常为bundle的id |
ifndef
判断一个key是否存在于指定(或默认)的资源文件中,如果不存在则进行该标记中的语句.
<i18n:ifndef key="zh_CN_ONLY">
Only users specifying something OTHER than zh_CN\
as their locale will see this!
</i18n:ifndef>
|
表9:ifndef的属性描述
| 属性名称 | 描述 | | key | 欲判断是否在资源文件中的key的名字 | | bundle | ResourceBundle的基本名,可以连同locale信息定位所需的ResourceBundle. | | bundleRef | 一个包含ResourceBundle的属性名,通常为bundle的id |
一个简单的例子
<%--
this page contains a variety of demonstrations of the <i18n:formatXXX> tags
--%>
<%@ taglib uri="http://jakarta.apache.org/taglibs/i18n-1.0" prefix="i18n" %>
<i18n:bundle baseName="i18n-test" id="bundle"/>
<%@ page import="java.util.Date" %>
<%@ page import="java.util.Locale" %>
<html>
<head>
<title>Examples of using the Formatting tags in the i18n Tag Library Tag</title>
</head>
<body>
<%
Number n = new Double( 1234567.89 );
Date d = new Date();
%>
<h2>default Locale</h2>
<h3>The time is now:-</h3>
<ul>
<li>
<i18n:formatTime style="medium" /> (medium)
</li>
</ul>
<h3>The date is now:-</h3>
<ul>
<li>
<i18n:formatDate pattern="yyyy MMMMM ddd hh:mm:ss"/> (pattern)
</li>
</ul>
<h3>The datetime is now:-</h3>
<ul>
<li>
<i18n:formatDateTime dateStyle="full" timeStyle="full"/> (full, full)
</li>
</ul>
<h3>The number is:-</h3>
<ul>
<li>
<i18n:formatNumber value="<%= n %>"/> (number)
</li>
<li>
<i18n:formatNumber value="<%= n %>" pattern="##,###,###.##"/> (number with pattern)
</li>
<li>
<i18n:formatCurrency value="<%= n %>"/> (currency)
</li>
<li>
<i18n:formatPercent value="<%= n %>"/> (percent)
</li>
</ul>
<h2>US Locale</h2>
<i18n:locale locale="<%= Locale.US %>">
<h3>The time is now:-</h3>
<ul>
<li>
<i18n:formatTime style="medium" /> (medium)
</li>
</ul>
<h3>The date is now:-</h3>
<ul>
<li>
<i18n:formatDate pattern="yyyy MMMMM ddd hh:mm:ss"/> (pattern)
</li>
</ul>
<h3>The datetime is now:-</h3>
<ul>
<li>
<i18n:formatDateTime dateStyle="full" timeStyle="full"/> (full, full)
</li>
</ul>
<h3>The number is:-</h3>
<ul>
<li>
<i18n:formatNumber value="<%= n %>"/> (number)
</li>
<li>
<i18n:formatNumber value="<%= n %>" pattern="##,###,###.##"/> (number with pattern)
</li>
<li>
<i18n:formatCurrency value="<%= n %>"/> (currency)
</li>
<li>
<i18n:formatPercent value="<%= n %>"/> (percent)
</li>
</ul>
</i18n:locale>
<h2> ifdef </h2>
<i18n:ifdef key="zh_CN_ONLY">
<i18n:message key="zh_CN_ONLY" />
</i18n:ifdef>
<h2> ifndef </h2>
<i18n:ifndef key="zh_CN_ONLY">
Only users specifying something OTHER than zh_CN
as their locale will see this!
</i18n:ifndef>
</body>
</html>
|
i18n-test.properties
i18n-test_zh_CN.properties
zh_CN_ONLY = 只有locale是zh_CN时才可以看到我！
|
注意要把资源文件拷贝到/WEB-INF/classes子目录下
标记库和源代码下载
taglibs.zip
关于作者 | | | 翟斌（David Zhai）毕业与北京航空航天大学自动控制专业，学士学位。毕业后一直从事软件开发工作，对网络安全，国际化/本地化有一定的研究。现任职于北京一家开发软件国际化工具的专业公司，从事软件国际化工具的研发。联系方式：
zhaibin@yahoo.com
|
对本文的评价
| |
