Struts2的国际化入门

Struts2国际化是建立在Java国际化的基础上的，一样是通过提供不同国家/语言环境的消息资源，然后通过ResourceBundle
加载指定Locale对应的资源文件，再取得该资源文件中指定key对应的消息--整个过程与JAVA程序的国家化完全相同，只是
Struts2框架对JAVA程序国际化进行了进一步封装，从而简化了应用程序的国际化。
Struts2需要国际化的部分
类型转换:
数据校验:
验证框架xml配置文件的国际化：RegisterAction-validation.xml文件<message key="username.xml.invalid"/>

JSP页面的国际化：<s:text name="addUser"/>

Action的国际化:利用ActionSupport类提供的getText()方法.

Struts2中加载全局资源文件

struts.xml
<constant name="struts.custom.i18n.resources" value="baseName"/>
或
struts.properties
struts.custom.i18n.resources=baseName

访问国际化消息

Struts2访问国际化消息主要有如下三种方式：
(1)JSP页面：<s:text name="key"/>
(2)Action类中：使用ActionSupport类的getText方法。
(3)表单元素的Label里：为表单元素指定一个key属性

输出带占位符的国际化消息

Struts2中提供了如下两种方式来填充消息字符串中的占位符

(1)JSP页面，在<s:text.../>标签中使用多个<s:param.../>标签来填充消息中的占位符。
(2)Action中，在调用getText方法时使用getText(String aTextName,List args)或getText(String key, String[] args)方法来填充占位符。
除此之外，Struts2还提供了对占位符的一种替代方式，这种方式允许在国际化消息资源文件中使用表达式，对于这种方式，则可避免在使用国际化消息时还需要为占位符传入参数

值。

如下在消息资源中使用表达式
succTip=${username}, 欢迎, 您已经登录!
在上面的消息资源中，通过使用表达式，可以从ValueStack中取出该username属性值，自动填充到该消息资源中。

加载资源文件的方式
(1)加载全局资源文件： <constant name="struts.custom.i18n.resources" value="baseName"/>
(2)包范围资源文件 ：为Struts2指定包范围资源文件的方法是,在包的根路径下建立多个文件名为package_language_country.properties的文件，一旦建立了
   这个系列的国际化资源文件，应用中处于该包下的所有Action都可以访问该资源文件。需要注意的是上面的包范围资源文件的baseName就是package，不是Action所在的包名。
(3)Action范围资源文件：在Action类文件所在的路径建立多个文件名为ActionName_language_country.properties的文件。
(4)临时指定资源文件：<s:i18n.../>标签的name属性指定临时的国际化资源文件

加载资源文件的顺序
Action中加载资源文件，假设我们在某个ChildAction中调用了getText("user.title")，Struts 2.0的将会执行以下的操作：
(1)优先加载系统中保存在ChildAction的类文件相同位置，且baseName为ChildAction的系列资源文件。
(2)如果在(1)中找不到指定key对应的消息，且ChildAction有父类ParentAction，则加载系统中保存在ParentAction的类文件相同位置，且
   baseName为ParentAction的系列资源文件。
(3)如果在(2)中找不到指定key对应的消息，且ChildAction有实现接口IChildAction，则加载系统中保存在IChildAction的类文件相同位置，且
   baseName为IChildAction的系列资源文件。
(4)如果在(3)中找不到指定key对应的消息，且ChildAction有实现接口ModelDriven(即使用模型驱动模式)，则对于getModel()方法返回的model对象，
   重新执行第(1)步操作。
(5)如果在(4)中找不到指定key对应的消息，则查找当前包下baseName为package的系列资源文件。
(6)如果在(5)中找不到指定key对应的消息，则沿着当前包上溯，直到最顶层包来查找baseName为package的系列资源文件。
(7)如果在(6)中找不到指定key对应的消息，则查找struts.custom.i18n.resources常量指定baseName的系列资源文件。
(8)如果经过上面的步骤一直找不到key对应的消息，将直接输出该key的字符串值。

对于在JSP中访问国际化消息，则简单的多，他们又可以分为两种形式：
(1)对于使用<s:i18n.../>标签作为父标签的<s:text.../>标签、表单标签的形式：
   a、将从<s:i18n.../>标签指定的国际化资源文件中加载指定key对应的消息。
   b、如果在a中找不到指定key对应的消息，则查找struts.custom.i18n.resources常量指定baseName的系列资源文件。
   c、如果经过上面步骤一直找不到该key对应的消息，将直接输出该key的字符串值。

(2)如果<s:text.../>标签、表单标签没有使用<s:i18n.../>标签作为父标签：
    直接加载struts.custom.i18n.resources常量指定baseName的系列资源文件。如果找不到该key对应的消息，将直接输出该key的字符串值。

允许用户自行选择程序语言

Struts2国际化的运行机制
    在Struts2中，可以通过ActionContext.getContext().setLocale(Locale arg)设置用户的默认语言。
为了简化设置用户默认语言环境，Struts2提供了一个名为i18n的拦截器(Interceptor),并且将其注册在默认的拦截器中(defaultStack)。
    i18n拦截器在执行Action方法前，自动查找请求中一个名为request_locale的参数。如果该参数存在，拦截器就将其作为参数，转换成Locale对象，
并将其设为用户默认的Locale(代表国家/语言环境)。
 除此之外，i18n拦截器还会将上面生成的Locale对象保存在用户Session的名为WW_TRANS_I18N_LOCALE的属性中。一旦用户Session中存在一个名为
WW_TRANS_I18N_LOCALE的属性，则该属性指定的Locale将会作为浏览者的默认Locale。
<%@ page language="java" contentType="text/html; charset=GBK"%>
<%@taglib prefix="s" uri="/struts-tags"%>
<script. type="text/javascript">
function langSelecter_onChanged()
{
 document.getElementById("langForm").submit();
}
</script>
<%-- 设置SESSION_LOCALE为用户session中的WW_TRANS_I18N_LOCALE属性值 --%>
<s:set name="SESSION_LOCALE" value="#session['WW_TRANS_I18N_LOCALE']"/>
<%-- 使用lee.Locales创建locales实例 --%>
<s:bean id="locales" name="lee.Locales">
 <%-- 为locales实例传入current参数值，如果SESSION_LOCALE为空，则返回ValueStack中locale属性值(即用户浏览器设置的Locale) --%>
 <s:param name="current" value="#SESSION_LOCALE == null ? locale : #SESSION_LOCALE"/>
</s:bean>

<%-- 让用户选择语言的表单 --%>
<form. action="<s:url/>" id="langForm"
    style="background-color:#bbbbbb; padding-top: 4px; padding-bottom: 4px;">
    <s:text name="languag"/>
 <s:select label="Language" list="#locales.locales" listKey="value" listValue="key"
        value="#SESSION_LOCALE == null ? locale : #SESSION_LOCALE"
        name="request_locale" id="langSelecter"
        nchange="langSelecter_onChanged()" theme="simple"/>
</form>

在其他页面中包含该页面:

<s:include value="selectlanguage.jsp"/>
在struts.xml文件中增加Action通配符的配置：
<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
        "http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
 <constant name="struts.custom.i18n.resources" value="messageResource"/>
 <constant name="struts.i18n.encoding" value="GBK"/>
    <package name="lee" extends="struts-default">
  <!-- 使用通配符定义Action的name -->
  <action name="*">
   <!-- 将请求转发给/WEB-INF/jsp/路径下同名的JSP页面 -->
   <result>/WEB-INF/jsp/{1}.jsp</result>
  </action>
    </package>
</struts>

版本：struts2.1.6

此实例实现功能：用户需要指定用户名登陆，登陆成功进入相应页面执行操作，否则返回到登陆页面进行登陆，当直接访问操作页面（登陆后才能访问的页面）时则不允许，须返回登陆页面。

代码如下：

一、页面

login.jsp

welcome.jsp

show.jsp

二、Action

LoginFormAction

LoginAction

ShowAction

三、拦截器

四 struts.xml

public String create(){
        creditCardTypeList = this.creditCardTypeService.getList();
       
        return SUCCESS;
}

Struts的配置文件：

<action name="create" method="create" class="example.CreditCardAction">     <result name="success">input.jsp</result>
</action>

input.jsp

...
<s:select name="creditCard.creditCardTypeId" list="creditCardTypeList" listKey="creditCardTypeId" 
                listValue="ccType" />
....

当提交input.jsp 的时候,Validate 检查没有通过，这时我需要回到input.jsp，此时应该下拉列表框的CreditType应该被保留,只需要在example.CreditCardAction 实现 Preparable接口，并实现prepare 方法，然后在add的 action中加上

<interceptor-ref name="prepare"/>
<interceptor-ref name="defaultStack"/>

public void prepare(){
    creditCardTypeList = this.creditCardTypeService.getList(); 
}

<action name="add" method="add" class="example.CreditCardAction">
    <interceptor-ref name="prepare"/>
    <interceptor-ref name="defaultStack"/>
    <result name="input">input.jsp</result>            
    <result name="success" type="redirect-action">
            <param name="namespace">/credit</param>
        <param name="actionName">list</param>
    </result>
</action>

  这样，在验证前将首先调用 prepare方法，即使失败了回到input.jsp页面creditCardType选择框的值仍然存在。

<interceptor-ref name="defaultStack"/> 中的 defaultStack 是我们在struts.xml 中配置的，其中我们注释掉了 <interceptor-ref name="prepare"/> 这样在example.CreditCardAction中的其他Action就不会首先执行prepare方法，只有加上了 <interceptor-ref name="prepare"/> 的才会去首先执行 prepare方法。

<package name="project-default" abstract="true" extends="struts-default">
         <interceptors>
         <interceptor-stack name="defaultStack">
                <interceptor-ref name="exception"/>
                <interceptor-ref name="alias"/>
                <interceptor-ref name="servletConfig"/>
                <!--                           
                <interceptor-ref name="prepare"/>
                 -->                              
                <interceptor-ref name="i18n"/>
                <interceptor-ref name="chain"/>
                <interceptor-ref name="debugging"/>
                <interceptor-ref name="profiling"/>
                <interceptor-ref name="scopedModelDriven"/>
                <interceptor-ref name="modelDriven"/>
                <interceptor-ref name="fileUpload"/>
                <!-- 
                <interceptor-ref name="checkbox">  
                       <param name="uncheckedValue">no</param>  
                </interceptor-ref>
                -->
                <interceptor-ref name="staticParams"/>
                <interceptor-ref name="params">
                  <param name="excludeParams">dojo..*</param>
                </interceptor-ref>
                <interceptor-ref name="conversionError"/>
                <interceptor-ref name="validation">
                    <param name="excludeMethods">input,back,cancel,browse</param>
                </interceptor-ref>
                <interceptor-ref name="workflow">
                    <param name="excludeMethods">input,back,cancel,browse</param>
                </interceptor-ref>
            </interceptor-stack>
       </interceptors>
    </package> 

首先，我们需要了解Struts2是将Action中的属性全部封装在一个叫做struts.valueStack的请求属性中，然后我们就可以通过下面的代码来获取这些值了：

<%@ page import="com.opensymphony.xwork2.util.*"%>
<%
ValueStack vs = (ValueStack)request.getAttribute("struts.valueStack");
List someThing= (List)vs.findValue("someThing");
%>

 someThing是Action中属性值的名称。

Struts2的属性驱动指的是在action中JSP页面的每一个form中的name都对应在action中有一个属性与之对应。看下面代码片段:

<form action="register.do" name="RegisterForm" method="post">

            Username:<input type="text" name="uname"><br>
            Password:<input type="password" name="upass"><br>
            Confirm: <input type="password" name="rpass"><br>
            <input type="submit" value="Submit">

</form>

这是一个最基本的用户注册的表单,它有三个数据要提交: uname、upass、rpass，那么对应的Action也要有三个属性（其实是三个属性的setter），看register.do实际的Action定义类：

package org.abu.csdn.action.user;

import com.opensymphony.xwork2.ActionSupport;

/**
 * Struts2属性驱动演示用的Action
 * @author 阿布
 *
 */
public class RegisterAction extends ActionSupport {

    private String uname;
    private String upass;
    private String rpass;

    public String getUname() {
        return uname;
    }

    public void setUname(String uname) {
        this.uname = uname;
    }

    public String getUpass() {
        return upass;
    }

    public void setUpass(String upass) {
        this.upass = upass;
    }

    public String getRpass() {
        return rpass;
    }

    public void setRpass(String rpass) {
        this.rpass = rpass;
    }
   
    @Override
    public String execute() throws Exception {       
        return ActionSupport.SUCCESS;
    }

}

你会看到RegisterAction中的三个属性和RegisterForm表单中的name属性名字一模一样，没错，这就是Struts2的属性驱动，当表单提交到RegisterAction后，Struts2将会自动将根据表单的name属性调用Action中相应的属性setter，去自动赋值。

2.Struts2的模型驱动

Struts2的模型驱动其实和Struts1.x中的ActionForm有点类似，在Struts1.x中每一个Action都必须有一个ActionForm与之对应，而Struts2.0中，每一个Action同样需要提供一个POJO对象，用来封装表单属性，看代码：

<form action="register.do" name="RegisterForm" method="post">

            Username:<input type="text" name="uname"><br>
            Password:<input type="password" name="upass"><br>
            Confirm: <input type="password" name="rpass"><br>
            <input type="submit" value="Submit">

</form>

这段表单的代码和上面的一模一样，就不赘述了。接下来看POJO的代码，其实就是普通的Java Bean：

package org.abu.csdn.action.user;

import com.opensymphony.xwork2.ActionSupport;

/**
 * Struts2属性驱动演示用的Java Bean
 * @author 阿布
 *
 */
public class User {

    private String uname;
    private String upass;
    private String rpass;

    public String getUname() {
        return uname;
    }

    public void setUname(String uname) {
        this.uname = uname;
    }

    public String getUpass() {
        return upass;
    }

    public void setUpass(String upass) {
        this.upass = upass;
    }

    public String getRpass() {
        return rpass;
    }

    public void setRpass(String rpass) {
        this.rpass = rpass;
    }
  
}

对不起，也是和属性驱动中的例子一样，很简单，因为演示的都是同一个例子，只是方法不同而已，但是接下来就不一样了，看RegisterAction代码：

package org.abu.csdn.action.user;

import org.abu.csdn.dto.User;

import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ModelDriven;

/**
 * Struts2模型驱动演示用的Action
 * 
 * @author 阿布
 *
 */
public class RegisterAction extends ActionSupport implements ModelDriven<User> {

    private User user;
   
    public User getUser() {
        return user;
    }

    public void setUser(User user) {
        this.user = user;
    }

    @Override
    public String execute() throws Exception {       
        return ActionSupport.SUCCESS;
    }

    // 模型驱动必须实现的方法，也是ModelDriven接口中唯一的方法
    public User getModel() {
       
        return user;
    }

}

看到没有，和属性驱动的Action有很大的区别，下面一一列举：

（1）模型驱动的Action必须实现ModelDriven接口，而且要提供相应的泛型，这里当然就是具体使用的Java Bean了。

（2）实现ModelDriven的getModel方法，其实就是简单的返回泛型的一个对象。

（3）在Action提供一个泛型的私有对象，这里就是定义一个User的user对象，并提供相应的getter与setter。

好了，上面的三件事做完之后，Action就会去自动调用User的setter将表单中的name属性的值赋给User中的属性。而Action的后续处理的Jsp页面后者是Servlet就可以使用user对象了。

3.到底是用属性驱动和是模型驱动呢？

这个问题困扰了很多Struts2的初学者，我这里提供一些建议：

（1）请你统一整个系统中的Action使用的驱动模型，即要么都是用属性驱动，要么都是用模型驱动。

（2）如果你的DB中的持久层的对象与表单中的属性都是一一对应的话，那么就使用模型驱动吧，毕竟看起来代码要整洁得多。

（3）如果表单的属性不是一一对应的话，那么就应该使用属性驱动，否则，你的系统就必须提供两个Bean，一个对应表单提交的数据，另一个用与持久层。

看上面的例子，其实密码确认rpass是不需要放到DB中去的，而仅仅是用于校验密码的，不是吗？那么如果使用模型驱动的话，就存在这个问题了，而使用属性驱动的话又有些繁琐，现在我们就来调整一个看我的解决方法：

4.完整的例子

（1）表单提交的JSP页面index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
<%@ taglib uri="/struts-tags" prefix="s"%>
<%
    String path = request.getContextPath();
    String basePath = request.getScheme() + "://"
            + request.getServerName() + ":" + request.getServerPort()
            + path + "/";
%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
    <head>
        <base href="<%=basePath%>">
        <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
        <title>CSDN首页</title>
    </head>
    <body>
        <s:a href="userManager/userRegister.jsp">用户注册</s:a>
       
        <form action="register.do" name="SampleForm" method="post">
            Username:<input type="text" name="uname"><br>
            Password:<input type="password" name="upass"><br>
            Confirm: <input type="password" name="rpass"><br>
            <input type="submit" value="Submit">
        </form>
    </body>
</html>

(2)User的定义

package org.abu.csdn.action.user;

import com.opensymphony.xwork2.ActionSupport;

/**
 * Struts2属性驱动演示用的Java Bean
 * @author 阿布
 *
 */
public class User {

    private String uname;
    private String upass; 

    public String getUname() {
        return uname;
    }

    public void setUname(String uname) {
        this.uname = uname;
    }

    public String getUpass() {
        return upass;
    }

    public void setUpass(String upass) {
        this.upass = upass;
    }  
  
}

（3）RegisterAction的定义

package org.abu.csdn.action.user;

import com.opensymphony.xwork2.ActionSupport;

/**
 * Struts2属性驱动演示用的Action
 * @author 阿布
 *
 */
public class RegisterAction extends ActionSupport {

    // 用来给spring注入，及属性拷贝

    private User user;

    private String uname;
    private String upass;
    private String rpass;

    public String getUname() {
        return uname;
    }

    public void setUname(String uname) {
        this.uname = uname;
    }

    public String getUpass() {
        return upass;
    }

    public void setUpass(String upass) {
        this.upass = upass;
    }

    public String getRpass() {
        return rpass;
    }

    public void setRpass(String rpass) {
        this.rpass = rpass;
    }
   
    @Override
    public String execute() throws Exception {

        // 调用方法将属性copy到user中去，便于后续的service方法

        copyAttribute();

        // TODO：编写自己的user业务代码
        return ActionSupport.SUCCESS;
    }

    /**
     * 注意这是一个action全局的校验
     */
    @Override
    public void validate() {
        // 进行密码的校验
        if (!(upass.trim()).equals((rpass.trim()))) {
            // 注意这里addFieldError的fieldName参数必须用引号引起来,
            // 不能这样使用addFieldError(rpass,"XXXXXX"),而必须是addFieldError("rpass","XXXXX")
            this.addFieldError("rpass", this
                    .getText("csdn.action.user.register.validate.verify"));
        }
    }

    /**
     * 将表单属性中需要持久化的属性拷贝到user中去
     * @author 阿布
     *
    */
    private void copyAttributes () {

            user.setUname(uname);

            user.setUpass(upass);

    }

}

（4）Struts.xml配置

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN"
    "http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>
    <package name="root" extends="struts-default" namespace="/userManager">
        <action name="userRegister" class="org.abu.csdn.action.user.RegisterAction">
            <result name="success">/index.jsp</result>
            <result name="input">/userManager/userRegister.jsp</result>
        </action>               
    </package>
</struts>

本文来自CSDN博客，转载请标明出处：http://blog.csdn.net/csuliky/archive/2009/05/30/4226917.aspx