传智Struts2笔记（13）国际化

[b]准备资源文件，资源文件的命名格式如下：[/b]
[color=green]baseName_language_country.properties
baseName_language.properties
baseName.properties[/color]
其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如：
中国大陆： baseName_zh_CN.properties
美国： baseName_en_US.properties

[b]现在为应用添加两个资源文件：[/b]
第一个存放中文：[color=red]itcast[/color]_zh_CN.properties
内容为：welcome=欢迎来到传智播客
第二个存放英语（美国）： [color=red]itcast[/color]_en_US.properties
内容为： welcome=welcome to itcast

对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下：
[color=red]native2ascii 源文件.properties 目标文件.properties[/color]

[b]配置全局资源与输出国际化信息[/b]
当准备好资源文件之后，我们可以在struts.xml中通过struts.custom.i18n.resources常量把资源文件定义为全局资源文件，如下：
<constant name="struts.custom.i18n.resources" value="[color=red]itcast[/color]" />
[color=red]itcast[/color]为资源文件的基本名。

后面我们就可以在页面或在action中访问国际化信息：
在JSP页面中使用<s:text name=“”/>标签输出国际化信息：
<s:text name=“user”/>，name为资源文件中的key
在Action类中，可以继承ActionSupport，使用getText()方法得到国际化信息，该方法的第一个参数用于指定资源文件中的key。
在表单标签中，通过key属性指定资源文件中的key，如：
<s:textfield name="realname" key="user"/>

[b]国际化—输出带占位符的国际化信息[/b]
资源文件中的内容如下：
welcome= {0}，欢迎来到传智播客{1}

在jsp页面中输出带占位符的国际化信息
<s:text name="welcome">
<s:param><s:property value="realname"/></s:param>
<s:param>学习</s:param>
</s:text>

在Action类中获取带占位符的国际化信息，可以使用getText(String key, String[] args)或getText(String aTextName, List args)方法。


[b]国际化—包范围资源文件[/b]
在一个大型应用中，整个应用有大量的内容需要实现国际化，如果我们把国际化的内容都放置在全局资源属性文件中，显然会导致资源文件变的过于庞大、臃肿，不便于维护，这个时候我们可以针对不同模块，使用包范围来组织国际化文件。

方法如下：
在java的包下放置package_language_country.properties资源文件，package为固定写法，处于该包及子包下的action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量struts.custom.i18n.resources指定的资源文件中寻找。


[b]国际化—Action范围资源文件[/b]
我们也可以为某个action单独指定资源文件，方法如下：
在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action类的简单名称。

当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，然后沿着当前包往上查找基本名为package 的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。


[b]国际化—JSP中直接访问某个资源文件[/b]
struts2为我们提供了<s:i18n>标签，使用<s:i18n>标签我们可以在类路径下直接从某个资源文件中获取国际化数据，而无需任何配置：
<s:i18n name="itcast">
<s:text name=“welcome”/>
</s:i18n>
Itcast为类路径下资源文件的基本名。

如果要访问的资源文件在类路径的某个包下，可以这样访问：
<s:i18n name=“cn/itcast/action/package">
<s:text name="welcome">
<s:param>小张</s:param>
</s:text>
</s:i18n>
上面访问cn.itcast.action包下基本名为package的资源文件。