内容: 综述 对时间,日期,货币,数字国际化 I18N标记库的一些高级用法 一个简单的例子 关于作者 翟斌(David Zhai) (zhaibin@yahoo.com) 2002 年 8 月
本文对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
OHTER_ONLY = a test
i18n-test_zh_CN.properties
zh_CN_ONLY = 只有locale是zh_CN时才可以看到我!
注意要把资源文件拷贝到/WEB-INF/classes子目录下
标记库和源代码下载
taglibs.zip 关于作者
翟斌(David Zhai)毕业与北京航空航天大学自动控制专业,学士学位。毕业后一直从事软件开发工作,对网络安全,国际化/本地化有一定的研究。现任职于北京一家开发软件国际化工具的专业公司,从事软件国际化工具的研发。联系方式:zhaibin@yahoo.com
|
|