Java的Struts框架中配置国际化的资源存储的要点解析

Z时代
2024-01-10
分类：IT

1、资源文件命名

国际化资源文件命名格式如下：

basename_language_country.properties

basename_language.properties

basename.properties

其中basename为资源文件的基本名称，language和country必须是java支持的语言和国家。获取java支持的语言和国家代码如下：


Locale[] locales = Locale.getAvailableLocales();
    for(Locale locale:locales){
      System.out.println("country:" + locale.getCountry() + ",language:" + locale.getLanguage());
    }

2、资源文件的配置和获取

新建资源文件，在中文环境下，资源文件中的value值需要进行ascii转换，可以通过运行后输入native2ascii进行转换，另外本文中使用了eclipse的属性文件插件，因此直接显示为中文。属性文件配置如下：

info_en_US.properties


username=zhangsan
info_zh_CN.properties
username=张三
info_zh.properties
username=李四
password=lisi
info.properties
username=王五
password=wangwu
email=邮箱

另外，如果需要读取到属性文件中的值，需要在struts-config.xml文件中配置常量。


<!-- 使用资源文件名称 ,其中value值代表资源文件的baseName-->
  <constant name="struts.custom.i18n.resources" value="info"></constant>

页面获取资源文件的方式为通过struts标签<s:text/>,如下所示：


  <!-- 资源文件获取key值 -->
  <s:text name="username"/>
  <s:text name="password"/>
  <s:text name="email"/>

另外，如果在form表单中获取key值，方式如下：


<!--其中key值为资源文件中的key值,作用是为输入框添加label名称，和label的属性值一样。但是在常量中会导致key值不能够从属性文件获取对应的value-->
<s:textfield name="login.username" key="username"></s:textfield>

另请注意在常量<constant name="struts.ui.theme" value="simple"/>使用时会导致<s:textfield/>中的key值不能够从属性文件获取对应的value。

最后页面显示结果如下：

从以上的配置文件中可以看出这三个值的取值来源，由此可以看出，资源文件的搜索顺序如下：

先从basename_language_country.properties中寻找相关的key值，没有则寻找basename_language.properties中寻找相关的key值，没有则到basename.properties中寻找相关的key值，没有则显示为name的值。

3、属性文件中占位符的使用

属性文件配置内容如下：

username=张三,{0},{1}

在jsp中使用标签<s:param>值</s:param>进行参数的传递。


<s:text name="username">
  <s:param>你好</s:param>
  <s:param>欢迎你!</s:param>
</s:text>

4、action中应用资源文件

在action中使用资源文件，需要继承ActionSupport类，ActionSupport类实现了TextProvider, LocaleProvider这两个接口，其中TextProvider提供了获取资源文件值的方法getText()方法，而LocaleProvider接口只有一个getLocale()方法，用来获取Locale。

修改配置文件info_zh_CN.properties:


username=张三,{0},{1}
usernameError=用户名称不能为空！请确认！

在action中，获取属性文件方法如下：


this.getText("usernameError");

在action中使用占位符进行操作，代码如下：


this.getText("username", new String[]{"你好","欢迎你"});

5、包范围的资源文件

处于该包以及子包下的action都能访问到该资源文件,放置位置为某个包下面，命名格式为：package_language_country.properties。其中package为固定格式。配置文件package_zh_CN.properties如下：

username=包范围下的username

在包下面的action中可以使用getText(“username”)的方式获取。

6、action范围的资源文件

可以为某个单独的action指定一个属性文件，放置位置为某个action同级目录下。命名格式为

ActionName_language_country.properties

。

配置action范围的属性文件：


username=action范围内的username

action中同样使用getText(“username”)方法进行获取值。

7、资源文件的加载顺序

对于action的使用getText(key)值来说，当同时存在action范围内的属性文件、包范围内的属性文件和全局属性文件时，加载顺序如下：

首先，在指定action内的属性文件是否存在key值，如果存在，则取值，如果不存在，则查找当前action上一级包中是否存在指定key值的包范围属性文件，不存在则继续上一级包中寻找，如果一直没有找到，则在全局的属性文件中寻找是否存在指定key值。如果存在指定的key值，则取出key值对应的value值，如果不存在，则默认为key值。

另外，当全局属性文件，有多个资源文件时，需要按照basename_language_country、basename_language、basename的顺序进行寻找。

8、页面获取资源文件

（1）使用<s:i18n/>访问某个资源文件。

代码如下：


  <!-- 使用i18n标签获取属性文件 -->
  <!-- 获取包范围下的资源文件 -->
  <s:i18n name="com/struts/package">
    <s:text name="username"></s:text>
  </s:i18n>
  <!-- 获取action范围下的资源文件 -->
  <s:i18n name="com/struts/service/LoginService">
    <s:text name="username"></s:text>
  </s:i18n>

（2）<fmt/>的使用

JSTL中包含了国际化和格式化标签，使用国际化标签可以让一个jsp页面可以根据访问者所在的区域输出不同语言的页面表述。在此需要使用Maven添加依赖jar包。配置文件如下：


 <!-- 引入jstl标签库 -->
  <dependency>
    <groupId>jstl</groupId> 
    <artifactId>jstl</artifactId>
    <version>1.2</version>
  </dependency>

在jsp页面使用fmt标签，应用代码如下：


<!-- 使用jstl标签fmt -->
  <!-- 设置语言环境，会覆盖客户端传递的怨言 -->
  <fmt:setLocale value="zh_CN" scope="request"/>
  <!-- 装载一个资源集，并保存在EL变量中 ，basename为基本名称，如果为包范围下则为com.struts.package，action范围下为com.struts.service.LoginService-->
  <fmt:setBundle basename="info" scope="request" var="baseName"/>
  <fmt:message key="username" bundle="${baseName }">
    <!-- 占位符的传递参数 -->
    <fmt:param value="您好"/>
    <fmt:param value="欢迎"/>
  </fmt:message><br/>
  <!--fmt:bundle 设置一个只在标签体内的访问的资源集 -->
  <!-- package范围下的资源文件 -->
  <fmt:bundle basename="com.struts.package">
    <fmt:message key="username"/>
  </fmt:bundle>
  <!-- action范围下的资源文件 -->
  <fmt:bundle basename="com.struts.service.LoginService">
    <fmt:message key="username"/>
  </fmt:bundle>