描述

WebWork在两个不同的地方支持国际化(简称 i18n): UI标签和 action/field 错误信息.

• Tags 一般指 i18n 和 text 标签
• 校验

资源包搜索顺序

资源包按照下面的顺序搜索:

1. ActionClass.properties
2. BaseClass.properties (所有的基类直到 Object.properties)
3. Interface.properties (每一个接口和子接口)
4. ModelDriven 的 model (如果实现了 ModelDriven), 对于 model 对象从第一步重复执行
5. package.properties (类所在的目录和每个父目录直到根目录)
6. 搜索 i18n message key 自己的层次关系
7. 全局资源属性 (webwork.custom.i18n.resources) ,在webwork.properties 里定义的

要了解更多的信息,请查阅 LocalizedTextUtil 类.

Package 层次关系 为了把 #5 阐述清楚, 当它在一个包的层次中遍历的时候, WebWork会寻找一个叫package.properties的文件: com/ acme/ package.properties actions/ package.properties FooAction.java FooAction.properties 如果 FooAction.properties 不存在,就会寻找com/acme/action/package.properties, 如果没有找到 com/acme/package.properties, 如果没有找到 com/package.properties, 依此类推.

例子

使用 getText()

为了显示 i18n 文字,你可以在property 标签里使用一个对getText()的调用,或者任何其它标签,例如UI标签(这尤其对UI标签的label有用):

<ww:property value="getText('some.key')" />

Text 标签

你也可以使用 text 标签:

<ww:text name="some.key" />

I18n 标签

也要注意到有一个i18n标签会把一个资源包推送到stack中,允许你显示不是前面提到的搜索层次关系中的资源包包含的文字.

<ww:i18n name="some.package.bundle" >
     <ww:text name="some.key" />
</ww:i18n>

 

在SiteMesh的装饰页面里面使用国际化是可能的,但是存在几个怪异之处.查阅 SiteMesh 页面来了解如何整合WebWork和SiteMesh,包括整合的技巧.

I18n 拦截器

查看 I18n Interceptor 了解更多信息. 它基本上就是在每个请求中把一个locale放到ActionContext Map中. Webwork (组件, ActionSupport 等.) 会感知到这个,并且每个i18n相关的部分都会使用这个locale.这也是一个基于request的改变locale的优雅方式.

在webwork.properties里配置的全局资源包 (webwork.custom.i18n.resources)

一个全局的资源包可以通过在webwork.properties里面设定 'webwork.custom.i18n.resources' 属性来做到. locale也可以通过在webwork.properties里面的 'webwork.locale' 属性来切换.

和Struts比较

Struts用户应该会熟悉使用application.properties资源包,在这个文件中你可以放置所有应用程序中要被翻译的信息.WebWork尽管把资源包拆成基于每个action或者model类的方式,但是你可能会在这些文件里不断重复文字信息.对此的一个快速修正方式就是创建一个叫ActionSupport.properties 的文件放在com/opensymphony/xwork 包中,并把它设置在classpath中.如果你的action都是ActionSupport的子类这会工作的很好.