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

时间:2021-10-26 10:10:23

1、资源文件命名

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

?
1
2
3
basename_language_country.properties
basename_language.properties
basename.properties

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

?
1
2
3
4
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

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
username=zhangsan
 
info_zh_CN.properties
 
username=张三
 
info_zh.properties
 
username=李四
password=lisi
 
info.properties
 
username=王五
password=wangwu
email=邮箱

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

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

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

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

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

?
1
2
<!--其中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。
最后页面显示结果如下:

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

从以上的配置文件中可以看出这三个值的取值来源,由此可以看出,资源文件的搜索顺序如下:
先从basename_language_country.properties中寻找相关的key值,没有则寻找basename_language.properties中寻找相关的key值,没有则到basename.properties中寻找相关的key值,没有则显示为name的值。

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

属性文件配置内容如下:

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

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

?
1
2
3
4
<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:

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

在action中,获取属性文件方法如下:

?
1
this.getText("usernameError");

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

?
1
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同级目录下。命名格式为

?
1
ActionName_language_country.properties


配置action范围的属性文件:

?
1
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/>访问某个资源文件。
代码如下:

?
1
2
3
4
5
6
7
8
9
<!-- 使用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包。配置文件如下:

?
1
2
3
4
5
6
<!-- 引入jstl标签库 -->
 <dependency>
   <groupId>jstl</groupId>
   <artifactId>jstl</artifactId>
   <version>1.2</version>
 </dependency>

在jsp页面使用fmt标签,应用代码如下:

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!-- 使用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>