Struts2国际化详细配置说明
一.首先了解一下什么是国际化:
国际化的英文为Internationalization,所以它又称为I18n(internationalization的首末字符i和n,18为中间的字符数)。i18n支持多种语言,但是同一时间只能是英文和一种选定的语言,例如英文+中文、英文+德文、英文+韩文等等;为了使不同国家地区的人使用到适应他们环境和语言的软件或网站,国际化成为了Java的必要因素之一。国际化机制在软件开发过程中,使得软件与特定的语言或地区脱钩。当我们做的软件被移植到其他国家时,不必更改软件本身的代码就可以适应当地区的使用了,所以国际化是必须的。
二.通过测试代码获得本机操作系统的默认语言和区域。
测试代码:
1 public static void main(String[] args) { 2 Locale defaultLocale=Locale.getDefault(); 3 System.out.println("country="+defaultLocale.getCountry()); 4 System.out.println("language="+defaultLocale.getLanguage()); 5 }
三.国际化的配置
1.先要配置baseName来指定资源文件,可在struts.xml文件中配置。
<constant name="struts.custom.i18n.resources" value="message"></constant>
注:代码中的message为baseName,此后的资源文件名必须为它。
2.资源文件
为了实现程序的国际化,必须先提供程序所需要的资源文件。资源文件的内容是很多的 key-value对,其中key是程序使用的部分,而value是程序的显示部分。
资源文件的命名可以是如下3种形式:
baseName_language_country.properties
baseName_language.properties
baseName.properties
其中baseName是资源文件的基本名称,用户可自由定义,而language和country都不可随意变化,必须是Java所支持的语言和国家。
Java不可能支持所有的国家和语言,可以通过Locale类的getAvailableLocale方法获取支持的,该方法返回一个Locale数组,该数组中包含了所有支持的国家和语言。
获取所支持的语言和国家代码如下:
1 public static void main(String[] args) { 2 Locale [] locales = Locale.getAvailableLocales(); 3 for(Locale locale:locales){ 4 //输出所有支持的国家 System.out.print(locale.getDisplayCountry()+":"+locale.getCountry()); 5 //输出所有支出的语言 System.out.println(locale.getDisplayLanguage()+":"+locale.getLanguage()); 6 } 7 }
首先编写两个资源文件,例如:
message_zh_CN.properties
title=标题
message_en_US.properties
title=title
struts2资源文件的管理:
a.全局范围,在classes路径下。
baseName-language-country.properties.如message_zh_CN.properties
b.包范围,在包根路径下。
package-language-country.properties.如package_zh_CN.properties
c.类范围,在该类同一路径下。
actionName-language-country.properties.如LoginAction_zh_CN.properties
3.struts2的国际化分三种情况,同时也分三个范围,分别为:前台页面的国际化,Action类中的国际化,验证框架xml配置文件的国际化。
1)为了在JSP页面中输出国际化消息,可以使用Struts2的<s:text…/>标签,该标签可以指定 一个name 属性,该属性指定了国际化资源文件中的key.
1 <%@ page language="java" contentType="text/html; charset=utf-8"%> 2 <%@ taglib uri="/struts-tags" prefix="s"%> 3 <html> 4 <head> 5 <!—使用s:text 标签输出国际化消息--> 6 <title><s:text name="loginPage"/></title> 7 </head> 8 <body> 9 <h3><s:text name="loginTip"/></h3> 10 <!—在表单元素中使用key来指定国际化消息的key--> 11 <s:form action="Login" method="post"> 12 <s:textfield name="username" key="user"/> 13 <s:password name="password" key="password"/> 14 <s:submit name="submit" key="submit" /> 15 </s:form> 16 </body> 17 </html>
2) 为了在Action类中访问国际化消息,可以使用ActionSupport类的getText方法,该方法可以接受一个name 参数,该参数指定了国际化资源文件中的key.
1 public class LoginAction extends ActionSupport{ 2 //完成输入校验需要重写的validate方法(读取资源文件getText(String str)) 3 public void validate(){ 4 //调用getText方法取出国际化信息 5 if(getUsername()==null||"".equals(this.getUsername().trim())){ 6 this.addFieldError("username", this.getText("username.required")); 7 } 8 if(this.getPassword()==null||"".equals(this.getPassword().trim())){ 9 this.addFieldError("password", this.getText("password.required")); 10 } 11 } 12 }
通过在Action类中调用ActionSupport类的getText通过这种方式,就可以取得国际化资源文件中的国际化消息。通过这种方式,即使Action需要设置在下一个页面显示的信息,也无需直接设置字符串常量,而是使用国际化消息的key来输出,从而实现程序的国际化。
3) 验证框架xml配置文件的国际化.
1 <!DOCTYPE validators PUBLIC 2 "-//Apache Struts//XWork Validator 1.0.3//EN" 3 "http://struts.apache.org/dtds/xwork-validator-1.0.3.dtd"> 4 <validators> 5 <field name="name"> 6 <field-validator type="requiredstring"> 7 <param name="tirm">true</param> 8 <message key="name"></message> 9 </field-validator> 10 </field> 11 </validators>
4.实现在jsp页面中的中英文切换。
Action中的代码:
1 public String changeLanguage() { 2 // 1、根据页面请求,创建下同的Locale对象 3 Locale locale = Locale.getDefault(); 4 if(flag.equals(null) || flag.equals("")){ 5 locale = new Locale("zh", "CN"); 6 }else if (flag.equals("zh")) { 7 locale = new Locale("zh", "CN"); 8 } else if (flag.equals("en")) { 9 locale = new Locale("en", "US"); 10 } 11 /* 12 * 2、设置Action中的Locale 前台页面的Locale和后台session中的Locale范围是不一样的 13 * a)只改页面Locale当前页面信息会改变但提交后Locale又会改回到默认的 14 * b)改变了后台Locale,当前线程中的页面Locale并不会改变,但会随下一次提交 15 * Action一同改变,所以可能要刷新页面两次,第一次只变后台Locale,第二次 前台和后台同时改变 16 * 为避免上述情况,需要前台和后台的Locale一起改变 17 */ 18 ActionContext.getContext().setLocale(locale); 19 ServletActionContext.getRequest().getSession().setAttribute("WW_TRANS_I18N_LOCALE", locale); 20 System.out.println(SystemUtil.getPropertiesValue("currentLang")+this.getText("login.name")); 21 return "SUCESS"; 22 }