struts2-国际化入门
如果我们的项目需要支持多国语言,则我们需要对项目进行国际化,下面简单介绍一下Struts2中为我们提供的国际化功能,仅作为入门知识
Struts2中的国际化资源文件分为以下3种:
1、全局范围的国际化
首先我们需要编写国际化资源文件,资源文件的命名如下:
baseName_language_country.properties
baseName_language.properties
其中baseName是资源文件的基本名,我们可以自定义,但language和country必须是java支持的语言和国家。如:
中国大陆: baseName_zh_CN.properties
美国: baseName_en_US.properties
现在为应用添加两个资源文件:
第一个存放中文:i18n_zh_CN.properties
内容为:message=您好,欢迎来到中国!
第二个存放英语(美国):i18n _en_US.properties
内容为:message=Hello, welcome to China!
当准备好资源文件之后,我们可以在struts.xml中通过struts.custom.i18n.resources常量把资源文件定义为全局资源文件,如下:
<!-- value的值为资源文件的基本名 --> <constant name="struts.custom.i18n.resources" value="i18n" />
资源文件在项目中的位置:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>欢迎页面</title> </head> <body> <s:text name="message" /> </body> </html>
部署项目,访问welcome.jsp页面,当本地环境是中文时,页面显示如下:
当本地环境是英文时,页面显示如下:
2、包范围的国际化
在一个大型应用中,整个应用有大量的内容需要实现国际化,如果我们把国际化的内容都放置在全局资源属性文件中,显然会导致资源文件变的过于庞大、臃肿,不便于维护,这个时候我们可以针对不同模块,使用包范围来组织国际化文件。
这时我们需要在要过国际化资源的包下放置package_language_country.properties资源文件,package为固定写法,处于该包及子包下的action都可以访问该资源。当查找指定key的消息时,系统会先从package资源文件查找,当找不到对应的key时,才会从常量struts.custom.i18n.resources指定的资源文件中寻找。
现在为应用添加包范围的两个资源文件:
第一个存放中文:package_zh_CN.properties
内容为:message=包范围:您好,欢迎来到中国!
第二个存放英语(美国):package_en_US.properties
内容为:message=package : Hello, welcome to China!
配置文件:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts> <!-- value的值为资源文件的基本名 --> <constant name="struts.custom.i18n.resources" value="i18n" /> <package name="user" namespace="/native" extends="struts-default"> <action name="native" class="com.struts.action.NativeAction"> <result name="success">/welcome.jsp</result> </action> </package> </struts>
资源文件在项目中的位置:
部署项目,访问native/native action时,当本地环境是中文时,页面显示如下:
当本地环境是英文时,页面显示如下:
从上面的结果也可以说明:当查找指定key的消息时,系统会先从package资源文件查找,当找不到对应的key时,才会从常量struts.custom.i18n.resources指定的资源文件中寻找。
3、Action范围的国际化
我们也可以为某个action单独指定资源文件,方法如下:在Action类所在的路径,放置ActionClassName_language_country.properties资源文件,ActionClassName为action类的简单名称。
当查找指定key的消息时,系统会先从ActionClassName_language_country.properties资源文件查找,如果没有找到对应的key,然后沿着当前包往上查找基本名为package 的资源文件,一直找到最顶层包。如果还没有找到对应的key,最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。
同样的现在我们为应用添加包范围的两个资源文件:
第一个存放中文:NativeAction_zh_CN.properties
内容为:message=action范围:您好,欢迎来到中国!
第二个存放英语(美国):NativeAction_en_US.properties
内容为:message=action : Hello, welcome to China!
配置文件:
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts> <!-- value的值为资源文件的基本名 --> <constant name="struts.custom.i18n.resources" value="i18n" /> <package name="user" namespace="/native" extends="struts-default"> <action name="native" class="com.struts.action.NativeAction"> <result name="success">/welcome.jsp</result> </action> </package> </struts>
资源文件在项目中的位置:
部署项目,访问native/native action时,当本地环境是中文时,页面显示如下:
当本地环境是英文时,页面显示如下:
从上面的结果与第二点中结论也可以说明:当查找指定key的消息时,系统会先从ActionClassName_language_country.properties资源文件查找,如果没有找到对应的key,然后沿着当前包往上查找基本名为package 的资源文件,一直找到最顶层包。如果还没有找到对应的key,最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。
输出带占位符的国际化信息:
更改上面全局范围的国际化资源文件的内容,如下:
i18n_zh_CN.properties-->message=您好,{0} 欢迎来到中国 {1}!
i18n _en_US.properties -->message=Hello, {0} welcome to China {1}!
在JSP页面中可以用标签<s:param></s:param>为占位符注入值,如:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="/struts-tags" prefix="s" %> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>欢迎页面</title> </head> <body> <s:text name="message"> <s:param>jetty</s:param> <s:param>study</s:param> </s:text> </body> </html>
部署项目,访问welcome.jsp页面,当本地环境是中文时,页面显示如下:
当本地环境是英文时,页面显示如下:
在Action中访问国际化资源:
1)没有占位符
在Action中可以继承ActionSupport,使用以下方法获取国际化资源文件中的信息
this.getText("资源文件中的key值");
2)有占位符
在Action中可以继承ActionSupport,使用以下方法获取国际化资源文件中带占位符的信息
// 该方法的第二个参数可以是数组或者是List,数组或List为给占位符注入的值 this.getText("资源文件中的key值", new String[]{}/*List*/);