使用 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>&nbsp;&nbsp;&nbsp;
    <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

posted on 2013-09-07 14:44  喜欢凯的蓝  阅读(9577)  评论(0编辑  收藏  举报