Struts2 Action处理请求参数：属性驱动和模型驱动

< 上一页Action访问Servlet API Result结果类型详解下一页 >

在 Struts2 框架中，页面的请求数据和 Action 有两种基本的对应方式，分别是字段驱动（FieldDriven，也称为属性驱动）方式和模型驱动（ModelDriver）方式。本节将针对这两种 Action 处理请求参数的方式进行详细讲解。

属性驱动

属性驱动是指在 Action 中通过字段属性进行与页面之间的数据传递，通常使用时会包括两种情况：一种是与基本数据类型的属性对应，另一种是直接使用域对象。

1. 基本数据类型字段驱动方式的数据传递

在 Struts2 中，可以直接在 Action 中定义各种 Java 基本数据类型的字段，使这些字段与表单数据相对应，并利用这些字段进行数据传递，如下面的代码所示：

public class UserAction extends ActionSupport {
    private String username; // 用户名
    private String password; // 密码
    // 此处省略两个属性的getter和setter方法
    private String execute() throws Exception {
        return SUCCESS;
    }
}

在上述 Action 类的代码中，定义了两个字符串字段 username 和 password，这两个字段分别用于对应页面上的用户名和密码这两个表单域。

2. 直接使用域对象字段驱动方式的数据传递

在基本数据类型字段驱动方式中，如果传入的数据很多，那么 Action 的属性也会变得很多，再加上属性对应的 getter/setter 方法，势必会导致 Action 非常臃肿。

为了解决这一问题，我们可以把属性的 getter/setter 方法从 Action 中提取出来单独作为一个域对象，并在相应的 Action 中直接使用这个域对象。此种方式中的域对象一般以 JavaBean 的形式实现，JavaBean 中所封装的属性要和页面中表单的属性一一对应。此时 JavaBean 将成为数据传递的载体，并可以在其他 Action 中使用。

下面通过具体的案例演示域对象字段的驱动方式的使用。

1）在 struts2Demo02 项目的 src 目录下创建一个名称为 com.mengma.domain 的包，在包中创建一个 User 类，编写代码后如下所示。

package com.mengma.domain;

public class User {
    private String username;
    private String password;

    // username的getter和setter方法
    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    // password的getter和setter方法
    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

2）在 com.mengma.action 包中创建一个名称为 UserLoginAction 的类，在类中定义一个 User 类型的域模型以及其 getter 和 setter 方法，如下所示。

package com.mengma.action;

import com.mengma.domain.User;
import com.opensymphony.xwork2.ActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class UserLoginAction extends ActionSupport {
    private User user; // 定义User属性

    // user属性的getter和setter方法

    public User getUser() {
        return user;
    }

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

    public String execute() throws Exception {
        // 获取Context对象
        ActionContext context = ActionContext.getContext();
        if ("admin".equals(user.getUsername())
                && "123456".equals(user.getPassword())) {
            // 将用户名和密码放入session中
            context.getSession().put("username", user.getUsername());
            context.getSession().put("password", user.getPassword());
            return SUCCESS;
        } else {
            context.getSession().put("error", "用户名或密码错误！");
            return ERROR;
        }

    }
}

在 UserLoginAction 中，首先声明了一个 User 类型的 user 对象，以及其 getter 和 setter 方法，然后在 execute() 方法中，获取了 ActionContext 对象以访问 Servlet API，下面通过对比从 User 对象获取的用户名和密码来判断是否登录成功。

需要注意的是，在使用域对象的属性驱动方式传值时，如果 JSP 页面是负责取值的，那么取值的格式必须为“对象名.属性名”；如果 JSP 页面是负责传值的，那么传值的格式可以为“模型对象名.属性名”，也可以直接是“属性名”。

3）分别创建登录页面 userLogin.jsp、登录成功页面 loginSuccess.jsp 和登录失败页面 loginError.jsp，如文件 userLogin.jsp、loginSuccess.jsp 和 loginError.jsp 所示。

① userLogin.jsp

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>用戶登录页面</title>
<style type="text/css">
input[type=text],input[type=password]{width:150px}
</style>   
</head>
<body>
   <div align="center">
     <form action="login" method="post">
      用户名：<input type="text" name="username"/><br/>
      密&nbsp;&nbsp;&nbsp;&nbsp;码：<input type="password" name="password"/><br/>
      <input type="reset" value="重置"/>
      <input type="submit" value="登录"/>
     </form>
   </div>
</body>
</html>

② loginSuccess.jsp

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>用戶登录成功页面</title>
</head>
<body>
    <p align="center">
     您的用戶名是<%=request.getAttribute("user.username") %>
     <br/>
     密码是<%=request.getAttribute("user.password") %>
    </p>
</body>
</html>

③ loginError.jsp

<%@ page language="java" contentType="text/html; charset=utf-8"
    pageEncoding="utf-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>错误页面</title>
</head>
<body>
    <p align="center">
        ${error }<br/>
        <a href="userLogin.jsp">请单击此链接返回登录页面重新登录</a>
    </p>
</body>
</html>

4）在配置文件 struts.xml 中的 <package> 元素中添加 UserLoginAction 的信息，添加内容如下所示：

<action name="userlogin" class="com.mengma.action.UserLoginAction">
    <result name="success">/loginSuccess.jsp</result>
    <result name="error">/loginError.jsp</result>
</action>

5）部署 struts2Demo02 项目到 Tomcat 服务器并启动服务器，在浏览器的地址栏中输入地址 http://localhost:8080/struts2Demo02/userLogin.jsp 访问 userLogin.jsp，浏览器的显示结果如图 1 所示。

在图 1 中输入正确的用户名“admin”和密码“123456”，单击【登录】按钮后，浏览器的显示结果如图 2 所示；如果用户名或密码错误，则进入错误页面，如图 3 所示。

图 1 登录页面

图 2 登录成功页面

图 3 错误页面

模型驱动

在 Struts2 中，Action 还有另外一种方式处理请求参数，称为模型驱动（ModelDriven）。

模型驱动方式要求 Action 需要通过实现 ModelDriven 接口接收请求参数，并且要重写 getModel() 方法。getModel() 方法返回的就是 Action 所使用的数据模型对象。

与属性驱动中直接使用域对象字段驱动方式的数据传递类似，模型驱动方式也是通过 JavaBean 模型进行数据传递的。只要是普通的 JavaBean，就可以充当模型部分，并且 JavaBean 中所封装的属性要与表单的属性一一对应，JavaBean 就是数据传递的载体。

使用模型驱动方式时，Action 类中通过 getModel() 方法获取模型，其示例代码如下所示：

package com.mengma.action;

import com.mengma.domain.User;
import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.ModelDriven;

public class LoginAction extends ActionSupport implements ModelDriven<User> {
    private User user = new User();

    public User getModel() {
        return user;
    }

    public String execute() throws Exception {
        return SUCCESS;
    }
}

使用模型驱动时，其对应的表单页面也要做相应调整，调整后的代码片段如下所示：

<form action="loginAction" method="post" name="form1">
    用户名：<input type="text" name="username"/><br/>
    密码：<input type="password" name="password"/><br/>
    <input type="submit" value="登录"/>
</form>

从上述代码中可以看出，使用 ModelDriver 的方式后，表单中的文本域名称已经不需要添加 user 前缀，页面上的 username 会自动对应到这个 Model 的 username 属性。

与属性驱动相比，模型驱动不需要在 Action 类中定义与表单元素一一对应的所有属性及其各属性的 getter 和 setter 方法，这减少了 Action 类中的代码量。在项目应用中具体使用哪种驱动方法，现给出以下几点建议。

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

2）如果持久层对象与表单中的属性是一一对应的关系，那么建议使用模型驱动，因为模型驱动方法使 Action 类中的代码更加整洁。

3）如果持久层对象与表单中的属性不是一一对应的关系，那么建议使用属性驱动，因为不是一一对应的关系时，系统中需要提供两个 JavaBean（一个对应表单提交的数据，一个用于持久层对象）。

总之，属性驱动的方法和模型驱动的方法各有优缺点，在实际开发中，需要根据项目实际情况选择使用哪种驱动方式。