您的位置:首页 > 编程语言 > Java开发

Struts2的国际化支持

2011-04-17 22:51 288 查看
软件的国际化涉及以下几个方面:

1. 界面静态的文字显示。
2. 提示信息,主要包括错误提示和操作提示、在线帮助等。
3. 日期时间、数字、度量以及货币等与使用习惯相关的一些提示。
4. 邮政编码格式、尊称和称谓习惯、电话号码格式以及地址格式等需要改变页面布局的一些内容。
5. 声音图片等涉及文化习惯的一些资源。

Struts2的国际化是建立在Java国际化的基础之上的,也是使用资源包的方式,通过getBundle()方法来寻找指定Local相关联的资源包,再从资源包文件中查找指定Key所对应的国际化资源信息。 Struts2框架的底层国际化与Java国际化是一致的,作为一个良好的MVC框架,Struts2将Java的国际化功能进行了封装和简化。

一、 配置资源文件

Struts2强调的是各个组件之间的松散耦合,各个组件之间都是通过配置文件来实现相关联和交互的。Struts2框架的国际化也是如此。

Struts2框架加载资源文件一般都是通过常量设置来完成的。配置资源文件常量,即配置Struts2框架的struts.custom.i18n.resources常量,该常量定义了Struts2框架全局国际化资源文件的basename。

配置struts.custom.i18n.resources常量,可以在属性文件struts.properties中定义,也可以在配置文件struts.xml或者web.xml中定义。
假设要定义配置一个basename为globalMessages的struts.custom.i18n.resources常量,可以在struts.properties文件中做如下配置:
#在属性文件中定义basename
struts.custom.i18n.resources=globalMessages
也可以在struts.xml文件中配置basename:
<constant name=" struts.custom.i18n.resources " value=" globalMessages "/>
同样,也可以在web.xml文件中定义:
<init-param>
<param-name> struts.custom.i18n.resources </param-name>
<param-value> globalMessages </param-value>
</init-param>

二、 Struts2的国际化应用

只要开发者指定了struts.custom.i18n.resources常量,即指定了国际化资源文件的basename,那么就可以开发国际化应用了。

1. 建立中文和英文的资源文件,globalMessages_en_US.properties和globalMessages_zh_CN.properties ,内容如下:

globalMessages_en_US.properties文件:
bbs_id=Article_Id
bbs_title=Title
bbs_author=Author
bbs_text=Context
bbs_date=date
bbs_first=First Page
bbs_next=Next Page
bbs_pre=Pre Page
bbs_last=Last Page

globalMessages_zh_CN.properties 文件:
bbs_id=/u6587/u7AE0/u5E8F/u53F7 (文章编号)
bbs_title=/u6587/u7AE0/u4E3B/u9898 (文章标题)
bbs_author=/u6587/u7AE0/u4F5C/u8005 (作者)
bbs_text=/u6587/u7AE0/u5185/u5BB9 (内容)
bbs_date=/u53D1/u8868/u65E5/u671F (日期)
bbs_first=/u9996/u9875 (首页)
bbs_next=/u4E0B/u9875 (下页)
bbs_pre=/u4E0A/u9875 (上页)
bbs_last=/u672B/u9875 (末页)

注意:由于中文为非西欧字符集,而Java使用的是Unicode作为字符编码,所
以中文要转换为Unicode编码。MyEclipse中提供了自动转换。

2. 访问资源文件

1. 用户视图访问国际化资源

<s:text/>是显示静态文本,该标签中可以使用key属性来输出国际化信息。Form元素的标签也可以使用key来获得国际化信息。例如:
<s:text name="bbs_title"/>
<s:textfield name="bbs_author" key="bbs_author"/>

2.Action访问国际化资源

Struts2提供了一个ActionSupport工具类,开发自己的Action,只要继承该类就可以了。在该类的API文档中,该类提供了一个getText(String tTextName)方法,该方法根据资源文件中的key值来返回一个国际化资源信息。
例如:Action中System.out.println(getText("bbs_author")+":"+bbs_author);

三、 使用占位符

globalMessages_en_US.properties文件:
welcomemsg=Hello {0},Now is {1}
globalMessages_zh_CN.properties 文件:
welcomemsg=你好 {0},现在时间是:{1}

1、 在JSP视图中输出支持占位符的国际化资源信息需要使用标签库,可以再<s:text/>标签中定义多个<s:param …/>子元素,来分别对应<s:text…/>标签中引用的国际化资源中的占位符。
如:<% Date now=new Date();%>
<s:text name="welcomemsg">
<s:param><s:property value="userName"/></s:param>
<s:param><%=now%></s:param>
</s:text>

2、 在Action中使用国际化资源占位符,仍然使用getText()方法,ActionSupport类中声明了多个getText()方法:

String getText(String aTextName):以国际化资源文件中的key为参数查找国际化信息。
String getText(String aTextName,List args):增加了一个List参数,作为填充占位符的参数,定义与MessageFormat一致。
String getText(String key,String[] args):增加了一个字符串数组参数,作为填充占位符的参数,定义与MessageFormat一致。
……等等方法
应用示例:
Date now=new Date();
System.out.println(getText("welcomemsg"),new String []
{username,now.toString()});

四、 包范围和Action范围的资源文件

前面使用的资源文件,是根据Struts2框架常量struts.custom.i18n.resources指定的basename来建立的,该资源文件是全局资源文件。 Struts2框架还允许建立包范围的资源文件、Action范围内的资源文件等。

1、 使用包资源文件的方法是:在包的根路径下建立多个文件名为package_language_country.properties的资源文件。 建好该包范围的资源文件后,该包中的所有的Action都可以访问了。
注意:上面package_language_country.properties中的package不是指配置文件中定义的包名,而是固定的名称:package。

2、 Action范围资源文件就是为单独的Action指定国际化资源。方法为:
在Action类所在的目录下,建立一个命名规范为ActionName_language_country.properties的资源文件。建立后,该Action就可以通过Action范围资源文件的访问来实现程序的国际互功能。

五、 动态访问国际化资源文件

配置文件struts-default.xml定义了一个国际化资源拦截器,部分代码如下:

<interceptor name="i18n"
class="com.opensymphony.xwork2.interceptor.I18nInterceptor" />
在该拦截器执行Action之前,会在用户请求中查找名为request_local的参数,如果该参数存在,拦截器将读取该值,转换为local对象,并将其设置为Action所使用的local。下面代码可以通过改变request_local请求参数来动态访问国际化资源文件。

<s:url id="url" action="DynamicAction">
<s:param name="request_local">en_US</param>
</s:url>
<s:a href="%{url}">English</s:a>

<s:url id="url" action="DynamicAction">
<s:param name="request_local">zh_CN</param>
</s:url>
<s:a href="%{url}">Chinese</s:a>
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: