在struts 2.0中国际化(i18n)您的应用程序

国际化是商业系统中不可或缺的一部分，所以无论您学习的是什么web框架，它都是必须掌握的技能。

其实，struts 1.x在此部分已经做得相当不错了。它极大地简化了我们程序员在做国际化时所需的工作，例如，如果您要输出一条国际化的信息，只需在代码包中加入file-name_xx_xx.properties（其中file-name为默认资源文件的文件名），然后在struts-config.xml中指明其路径，再在页面用标志输出即可。

不过，所谓“没有最好，只有更好”。struts 2.0并没有在这部分止步，而是在原有的简单易用的基础上，将其做得更灵活、更强大。

国际化hello world

下面让我们看一个例子——helloworld。这个例子演示如何根据用户浏览器的设置输出相应的helloworld。

在eclipse创建工程配置开发和运行环境（如果对这个步骤有问题，可以参考我早前的文章《为struts 2.0做好准备》）。

在src文件夹中加入struts.properties文件，内容如下：

struts.custom.i18n.resources=globalmessages

struts 2.0有两个配置文件，struts.xml和struts.properties都是放在web-inf/classes/下。

struts.xml用于应用程序相关的配置
struts.properties用于struts 2.0的运行时（runtime）的配置

在src文件夹中加入globalmessages_en_us.properties文件，内容如下：
helloworld=hello world!

在src文件夹中加入globalmessages_zh_cn.properties文件，内容如下：

helloworld=你好，世界！

在此想和大家分享一个不错的编写properties文件的eclipse插件（plugin），有了它我们在编辑一些简体中文、繁体中文等unicode文本时，就不必再使用native2ascii编码了。您可以通过eclipse中的软件升级（software update）安装此插件，步骤如下：

1、展开eclipse的help菜单，将鼠标移到software update子项，在出现的子菜单中点击find and install；
2、在install/update对话框中选择search for new features to install，点击next；
3、在install对话框中点击new remote site；
4、在new update site对话框的name填入“propedit”或其它任意非空字符串，在url中填入http://propedit.sourceforge.jp/eclipse/updates/；
5、在site to include to search列表中，除上一步加入的site外的其它选项去掉，点击finsih；
6、在弹出的updates对话框中的select the features to install列表中将所有结尾为“3.1.x”的选项去掉（适用于eclipse 3.2版本的朋友）；
7、点击finish关闭对话框；
8、在下载后，同意安装，再按提示重启eclipse，在工具条看到形似vi的按钮表示安装成功，插件可用。此时，eclpise中所有properties文件的文件名前有绿色的p的图标作为标识。

在webcontent文件夹下加入helloworl.jsp文件，内容如下：
<%@ page contenttype="text/html; charset=utf-8"%>
<%@taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>hello worldtitle>
head>
<body>
<h2><s:text name="helloworld"/>h2>
<h2><s:property value="%{gettext('helloworld')}"/>h2>
body>
html>
发布运行应用程序，在浏览器地址栏中输入，出现图1所示页面。

图1 中文输出
将浏览器的默认语言改为“英语（美国）”，刷新页面，出现图2所示页面。

图2 英文输出

上面的例子的做法，与struts 1.x的做法相似，似乎并不能体现struts 2.0的优势。不过，我在上面的例子用了两种方法来显示国际化字符串，其输出是相同的。其实，这就是struts 2.0的一个优势，因为它默认支持el，所示我们可以用gettext方法来简洁地取得国际化字符串。另外更普遍的情况——在使用ui表单标志时，gettext可以用来设置label属性，例如：

<s:textfield name="name" label="%{gettext('username')}"/>

资源文件查找顺序

之所以说struts 2.0的国际化更灵活是因为它可以能根据不同需要配置和获取资源（properties）文件。在struts 2.0中有下面几种方法：

使用全局的资源文件，方法如上例所示。这适用于遍布于整个应用程序的国际化字符串，它们在不同的包（package）中被引用，如一些比较共用的出错提示；
使用包范围内的资源文件。做法是在包的根目录下新建名的package.properties和package_xx_xx.properties文件。这就适用于在包中不同类访问的资源；
使用action范围的资源文件。做法为action的包下新建文件名（除文件扩展名外）与action类名同样的资源文件。它只能在该action中访问。如此一来，我们就可以在不同的action里使用相同的properties名表示不同的值。例如，在actonone中title为“动作一”，而同样用title在actiontwo表示“动作二”，节省一些命名工夫；
使用标志访问特定路径的properties文件。使用方法请参考我早前的文章《常用的struts 2.0的标志（tag）介绍》。在您使用这一方法时，请注意标志的范围。在到之间，所有的国际化字符串都会在名为xxxxx资源文件查找，如果找不到，struts 2.0就会输出默认值（国际化字符串的名字）。

上面我列举了四种配置和访问资源的方法，它们的范围分别是从大到小，而struts 2.0在查找国际化字符串所遵循的是特定的顺序，如图3所示：

图3 资源文件查找顺序图

假设我们在某个childaction中调用了gettext("user.title")，struts 2.0的将会执行以下的操作：

查找childaction_xx_xx.properties文件或childaction.properties；
查找childaction实现的接口，查找与接口同名的资源文件myinterface.properties；
查找childaction的父类parentaction的properties文件，文件名为parentaction.properties；
判断当前childaction是否实现接口modeldriven。如果是，调用getmodel()获得对象，查找与其同名的资源文件；
查找当前包下的package.properties文件；
查找当前包的父包，直到最顶层包；
在值栈（value stack）中，查找名为user的属性，转到user类型同名的资源文件，查找键为title的资源;
查找在struts.properties配置的默认的资源文件，参考例1;
输出user.title。

参数化国际化字符串

许多情况下，我们都需要在动行时（runtime）为国际化字符插入一些参数，例如在输入验证提示信息的时候。在struts 2.0中，我们通过以下两种方法做到这点：

在资源文件的国际化字符串中使用ognl，格式为${表达式}，例如：
validation.require=${gettext(filename)} is required
使用中的字符串格式，格式为{ 参数序号（从0开始）, 格式类形（number | date | time | choice）, 格式样式}，例如：
validation.between=date must between {0, date, short} and {1, date, short}

在显示这些国际化字符时，同样有两种方法设置参数的值：

使用标志的value0、value1...valuen的属性，如：
<s:text name="validation.required" value0="user name"/>
使用param子元素，这些param将按先后顺序，代入到国际化字符串的参数中，例如：
<s:text name="validation.required">
<s:param value="user name"/>
s:text>

让用户方便地选择语言

开发国际化的应用程序时，有一个功能是必不可少的——让用户快捷地选择或切换语言。在struts 2.0中，通过actioncontext.getcontext().setlocale(locale arg)可以设置用户的默认语言。不过，由于这是一个比较普遍的应用场景（scenario），所以struts 2.0为您提供了一个名i18n的拦截器（interceptor），并在默认情况下将其注册到拦截器链（interceptor chain）中。它的原理为在执行action方法前，i18n拦截器查找请求中的一个名为"request_locale"的参数。如果其存在，拦截器就将其作为参数实例化locale对象，并将其设为用户默认的区域（locale），最后，将此locale对象保存在session的名为“ww_trans_i18n_locale”的属性中。

下面，我将提供一完整示例演示它的使用方法。

package tutorial;

import java.util.hashtable;

import java.util.locale;

import java.util.map;

publicclass locales {

public map<string, locale> getlocales() {

map<string, locale> locales =new hashtable<string, locale>(2);

locales.put("american english", locale.us);

locales.put("simplified chinese", locale.china);

return locales;

}

tutorial/locales.java

<%@taglib prefix="s" uri="/struts-tags"%>
<script type="text/javascript">

script>
<s:set name="session_locale" value="#session['ww_trans_i18n_locale']"/>
<s:bean id="locales" name="tutorial.locales"/>
<form action="get" encode="true"/>" name="langform"
style="background-color: powderblue; padding-top: 4px; padding-bottom: 4px;">
language: <s:select label="language"
list="#locales.locales" listkey="value" listvalue="key"
value="#session_locale == null ? locale : #session_locale"
name="request_locale" id="langselecter"
onchange="langselecter_onchanged()" theme="simple"/>
form>

langselector.jsp

上述代码的原理为，langselector.jsp先实例化一个locales对象，并把对象的map类型的属性locales赋予下拉列表（select）。如此一来，下拉列表就获得可用语言的列表。大家看到langselector有标志和一段javascript脚本，它们的作用就是在用户在下拉列表中选择了后，提交包含“reqeust_locale”变量的表单到action。在打开页面时，为了下拉列表的选中的当前区域，我们需要到session取得当前区域（键为“ww_trans_i18n_locale”的属性），而该属性在没有设置语言前是为空的，所以通过值栈中locale属性来取得当前区域（用户浏览器所设置的语言）。

你可以把langselector.jsp作为一个控件使用，方法是在jsp页面中把它包含进来，代码如下所示：

<s:include value="/langselector.jsp"/>

在例1中的hellloworld.jsp中后加入上述代码，并在struts.xml中新建action，代码如下：

<action name="helloworld">
<result>/helloworld.jspresult>
action>

或者，如果你多个jsp需要实现上述功能，你可以使用下面的通用配置，而不是为每一个jsp页面都新建一个action。

<action name="*">
<result>/{1}.jspresult>
action>

分布运行程序，在浏览器的地址栏中输入，出现图4所示页面：

图3 helloworld.action

在下拉列表中，选择“american english”，出现图5所示页面：

图4 helloworld.action

可能大家会问为什么一定要通过action来访问页面呢？
你可以试一下不用action而直接用jsp的地址来访问页面，结果会是无论你在下拉列表中选择什么，语言都不会改变。这表示不能正常运行的。其原因为如果直接使用jsp访问页面，struts 2.0在web.xml的配置的过滤器（filter）就不会工作，所以拦截器链也不会工作。

posted on 2006-11-01 19:06 max 阅读(72866) 评论(123) 所属分类: struts 2.0系列

国际化hello world

资源文件查找顺序

参数化国际化字符串

让用户方便地选择语言

常用链接

留言簿(253)

在struts 2.0中国际化(i18n)您的应用程序 -凯发k8网页登录

搜索

最新评论

阅读排行榜

评论排行榜


只有注册用户后才能发表评论。




网站导航:
相关文章: 在struts 2中实现文件上传在struts 2中实现ioc struts 2的基石——拦截器（interceptor）