最近发现一些网站在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参数已经知道了。