通过实例学习Struts2 - 从struts-blank开始 (3)

最近发现一些网站在Copy&Paste我的文章， 请尊重我的劳动成果，在转载的时候注明出处，谢谢。

接上一篇《通过实例学习Struts2 - 从struts-blank开始  (2)》

国际化

国际化通俗点讲就是支持多语言，在Struts2中我们要解决几个问题

1. 如何告诉Struts2 当前的Locale 是什么

2. Struts2是如何寻找不同Locale的resource文件的

3. 如何使用Resource文件

设置Locale

在我们的struts-blank项目中，HelloWorld.jsp中有这样的代码：

<h3>Languages</h3>
<ul>
    <li>
        <s:url id="url" action="HelloWorld">
            <s:param name="request_locale">en</s:param>
        </s:url>
        <s:a href="%{url}">English</s:a>
    </li>
    <li>
        <s:url id="url" action="HelloWorld">
            <s:param name="request_locale">es</s:param>
        </s:url>
        <s:a href="%{url}">Espanol</s:a>
    </li>
</ul>

仔细读一下就会明白， 这段代码是通过 <s:url > 来定义了两个url ，带的参数分别是 request_locale=en , 和request_locale=es

然后使用<s: a href=... > 来创建链接，生成的最终html会是这样：

<h3>Languages</h3>
<ul>
    <li>
        <a href="/struts2-blank/example/HelloWorld.action;jsessionid=2F2C1A03C75BDF7893E7450998FBC3FB?request_locale=en">English</a>
    </li>
    <li>
        <a href="/struts2-blank/example/HelloWorld.action;jsessionid=2F2C1A03C75BDF7893E7450998FBC3FB?request_locale=es">Espanol</a>
    </li>
</ul>

分别对应en(英语) 和es(西班牙语？ )

点击这两个link,系统的语言就会切换， 实际上我们看到唯一传递给struts2的参数就是request_locale , 没错，就是这个参数告诉了Struts2用什么样的locale !

那么Struts2在背后究竟干了什么事呢？ 这需要了解一些Struts2架构， Struts2内置了很多拦截器，这些拦截器会在你的Action运行之前调用，其中有个拦截器叫做i18n， 它会检查http request 有没有名称为request_locale的参数，如果有， 转换为Locale对象， 设置为用户默认的Locale , 并且会把这个Locale保存在用户Session中，名为WW_TRANS_I18N_LOCALE。

所以只要你调用了一次request_locale=xxxx,  在session失效之前，locale就会保持不变。

当然，如果你想用java代码的方式来指定 Locale也是可以的：

ActionContext.getContext().setLocale(Locale locale)

查找Resource 文件

解决了如何设置Locale的问题， 我们再研究一下Struts2是如何查找Resource文件的。

如果让我们自己写的话，在java中最常用的就是ResourceBoundle , 通过它可以指定一个baseName，以及ClassLoader 来装载指定目录下的resource 文件，有兴趣的同学科参见我的另一篇文章《深入ResourceBundle》。

在我们的struts-blank项目中，有两个文件叫package.properties 和package_es.properties，这两个resource 文件和其他的Action类放在同一个java package 下

可以这么猜测，同一个java package 下的所有Action类，都会用package_xx_xx..properties 作为resource 文件。

我们在后边的例子中还会看到诸如这样的Resource 文件： <ActionName>_zh_CN.properties, 很明显这是为特定的Action所设置的

但实际情况中， 估计大多少项目都会把resource 文件同意放到一起，Struts2 称之为全局配置文件，可以这么指定：

<constant name="struts.custom.i18n.resources" value="baseName"/>

这三种方式是有优先级的： Action级> Package级 > 全局配置

实际上Struts2 支持更为复杂的搜索方式，这里就不展开了，感兴趣的同学可以看看Struts2 的教程

我不太理解为什么Struts2会有如此复杂的方式来定位Resource 文件， 在我这些年的工作经验中，resource文件总是统一放在一个指定的目录下，方便集中管理，也方便一次性的把所有的英文的Resource 文件发出去翻译。

不太清楚如果Resource如果是分散在各个package下面会有什么好处， 有经验的同学请不吝赐教

如何使用Resource文件

主要用两种方式：

(1) 在jsp 中： <s:text name="key"/>

(2) 在Java 中： 使用ActionSupport类的getText(.....)方法

注意在这两种方法中我们都没有指定Locale, 因为Struts通过request_loacle参数已经知道了。