在 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]{150px} </style> </head> <body> <div align="center"> <form action="login" method="post"> 用户名:<input type="text" name="username"/><br/> 密 码:<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 所示。
模型驱动
在 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(一个对应表单提交的数据,一个用于持久层对象)。