使用 Struts 2 实现国际化
struts2国际化(I18N)
国际化也叫I18N,是Internationalization的简称。Struts2国际化是建立在Java国际化基础上,只是Struts2框架对Java国际化进行了进一步封装,从而简化了应用程序的国际化。
使用struts2 实现国际化
在上一次的”使用 Struts2 校验器校验用户注册信息“项目为基础上实现国际化:http://www.cnblogs.com/likailan/p/3302284.html
一、在strute.xml中指定资源文件的基名。
在strute.xml文件的struts标签里加入如下代码:
<constant name="struts.custom.i18n.resources" value="message"/> <constant name="struts.i18n.encoding" value="UTF-8" />
通过“struts.custom.i18n.resources”属性指定国际化资源文件的基名为“message”,位于src目录下。如果属性值为“cn.jbit.message”,则资源文件的基名仍是“message”,但位于“cn.jbit”包中。还可以通过“struts.i18n.encoding”属性指定默认的编码方案。如果要进行国际化,必须指定为“UTF-8”。
二、创建资源文件,用来存放相应的资源
资源文件为properties文件,命名规则为:基名 _语言代号_地区代号.properties。基名就是第一步里设置的“message”。语言代号和地区代号可以在IE里查看:打开IE->打开internet选项->点击语言->点击添加,可以看到如下“添加语言”对话框,里面就有显示各种语言和地区的代号:
在src目录下添加分别为 中文-中国 和 英文-美国 的资源文件。那么对应的文件名就是:
中文-中国:message_zh_CN.properties
英文-美国:message_en_US.properties
message_zh_CN.properties代码:
title=注册
form.email=邮箱:
form.password=密码:
form.repassword=重复密码:
form.phone=电话:
form.submit=提交
message_en_US.properties代码:
title=register
form.email=eMail:
form.password=password:
form.repassword=repassword:
form.phone=phone:
form.submit=submit
三、实现JSP页面信息的国际化显示
把和显示相关的文字都替换成 <s:text name="对应资源文件的键"/> 其中属性 name 的值为资源文件里相对应的key。如:<s:text name="title"/> <s:text name="form.email"/>
页面代码:
1 <%@ page language="java" contentType="text/html; charset=UTF-8" 2 pageEncoding="UTF-8"%> 3 <!-- 加载struts2标签库 --> 4 <%@ taglib uri="/struts-tags" prefix="s"%> 5 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 6 <html> 7 <head> 8 <s:head/> 9 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 10 <!-- 把和显示相关的文字都替换成 <s:text name="对应资源文件的键"/> --> 11 <title><s:text name="title" /></title> 12 </head> 13 <body> 14 <form action="register.action" method="post"> 15 <table> 16 <tr> 17 <!-- 把和显示相关的文字都替换成 <s:text name="对应资源文件的键"/> --> 18 <td><s:text name="form.email" /></td> 19 <td><input type="text" name="email"/></td> 20 <!-- 使用<s:fielderror/>标签输入相应的字段错误信息 --> 21 <td><s:fielderror fieldName="email"/></td> 22 </tr> 23 <tr> 24 <!-- 把和显示相关的文字都替换成 <s:text name="对应资源文件的键"/> --> 25 <td><s:text name="form.password" /></td> 26 <td><input type="password" name="password"/></td> 27 <td><s:fielderror fieldName="password"/></td> 28 </tr> 29 <tr> 30 <td><s:text name="form.repassword" /></td><td> 31 <input type="password" name="repassword"/></td> 32 <td><s:fielderror fieldName="repassword"/></td> 33 </tr> 34 <tr> 35 <td><s:text name="form.phone" /></td> 36 <td><input type="text" name="phone"/></td> 37 <td><s:fielderror fieldName="phone"/></td> 38 </tr> 39 <tr> 40 <td><input type="submit" value="<s:text name="form.submit" />"/></td> 41 <td></td> 42 <td></td> 43 </tr> 44 </table> 45 </form> 46 </body> 47 </html>
四、测试
启动tomcat。用IE打开register.jsp页面。
打开internet选项->点击语言->点击添加,可以看到如下“添加语言”对话框。添加“英语(美国)[en-US]”项,并把该项上移到最上层
刷新页面:
实现验证错误信息的国际化显示
表单的验证错误信息也需要进行国际化显示,Struts 2 针对编码验证和验证框架都提供了国际化实现,此时验证错误信息以键值对的方式书写在资源文件中,而无需直接书写在validate方法或者验证配置文件中。
一、添加相应的国际化内容到资源文件中
message_zh_CN.properties添加如下国际化内容:
######### 校验错误信息 ###########
form.email.null=邮箱不能为空
form.email.format=邮箱格式不正确
form.password.null=密码不能为空
form.password.length=密码长度不能少于6位
form.repassword.same=两次密码不一至
form.phone.format=电话号码格式不正确
message_en_US.properties添加如下国际化内容:
######### 校验错误信息 ###########
form.email.null=eMail cannot be null
form.email.format=eMail format is error
form.password.null=password cannot be null
form.password.length=minimum password length is 6
form.repassword.same=repassword should be same with password
form.phone.format=phone format is error
二、修改验证框架的配置文件
修改验证框架的配置文件,去掉具体的验证错误信息,通过 <message> 标签的key属性指定其对应的验证错误信息。
修改后的 RegisterAction-register-validation.xml:
1 <?xml version="1.0" encoding="UTF-8"?> 2 <!DOCTYPE validators PUBLIC 3 "-//Apache Struts//XWork Validator 1.0.2//EN" 4 "http://struts.apache.org/dtds/xwork-validator-1.0.2.dtd"> 5 6 <validators> 7 <!-- name值为需要被校验的字段,这里对email字段进行校验 --> 8 <field name="email"> 9 <!-- type值为校验器名,requiredstring:非空字符串校验器 --> 10 <field-validator type="requiredstring"> 11 <!-- 去掉具体的验证错误信息,通过 <message> 标签的key属性指定其对应的验证错误信息。 --> 12 <message key="form.email.null" /> 13 </field-validator> 14 <!-- 一个字段可以配置多个校验器,email:校验邮箱格式 --> 15 <field-validator type="email"> 16 <!-- 去掉具体的验证错误信息,通过 <message> 标签的key属性指定其对应的验证错误信息。 --> 17 <message key="form.email.format" /> 18 </field-validator> 19 </field> 20 21 <field name="password"> 22 <field-validator type="requiredstring"> 23 <message key="form.password.null" /> 24 </field-validator> 25 <!-- stringlength:字符串长度校验 --> 26 <field-validator type="stringlength"> 27 <!-- 为校验器指定参数实现不同的校验规则,minlength:最少长度 --> 28 <param name="minLength">6</param> 29 <message key="form.password.length"/> 30 </field-validator> 31 </field> 32 33 <!-- 校验两次密码是否一致,使用 fieldexpression 校验器。expression参数指定判断用的表达式 --> 34 <field name="repassword"> 35 <field-validator type="fieldexpression"> 36 <!-- 表达式要写在 <![CDATA[]]> 内 --> 37 <param name="expression"><![CDATA[repassword==password]]></param> 38 <message key="form.repassword.same"/> 39 </field-validator> 40 </field> 41 42 <!-- 校验电话格式,使用regex正则表达示校验,regexExpression参数指定正则表达式 --> 43 <field name="phone"> 44 <field-validator type="regex"> 45 <!-- 注意!2.3.15前的版本使用 expression 参数 --> 46 <param name="regexExpression"><![CDATA[\d{11}]]></param> 47 <message key="form.phone.format" /> 48 </field-validator> 49 </field> 50 51 </validators>
四、测试
打开internet选项->点击语言->点击添加,可以看到如下“添加语言”对话框。添加“英语(美国)[en-US]”项,并把该项上移到最上层。刷新页面:
通过超链接转换页面 语言-地区
一、在register.jsp页面中添加如下超连接:
<a href="changelan.action?request_locale=zh_CN">简体中文</a> <a href="changelan.action?request_locale=en_US">English</a>
跳到一个名为changelan的action里,传递名为request_locale(固定写化)的参数,值为要换转的 语言代号_地区代号。
二、编写相应的action类
ChangelanAction.java代码:
1 import java.util.Locale; 2 3 import com.opensymphony.xwork2.ActionContext; 4 import com.opensymphony.xwork2.ActionSupport; 5 6 7 public class ChangelanAction extends ActionSupport{ 8 9 public String execute() throws Exception { 10 //获得本地默认的语言环境 11 Locale locale=Locale.getDefault(); 12 //存入到一个session变量中。"WW-TRANS-I18N-LOCALE"为固定写法 13 ActionContext.getContext().getSession().put("WW-TRANS-I18N-LOCALE", locale); 14 return SUCCESS; 15 } 16 17 }
三、配置struts.xml
在package标签内添加如下action标签:
<action name="changelan" class="ChangelanAction"> <result name="success">register.jsp</result> </action>
四、测试
页面如下:
点击简体中文:
点击English