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" style="margin: 0cm 0cm 0pt;">?资源文件在项目中的位置:?
?部署项目,访问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" style="margin: 0cm 0cm 0pt;">??资源文件在项目中的位置:??
?
?部署项目,访问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*/);?