在 Struts2 框架中,页面的请求数据和 Action 有两种基本的对应方式,分别是字段驱动(FieldDriven,也称为属性驱动)方式和模型驱动(ModelDriver)方式。本节将针对这两种 Action 处理请求参数的方式进行详细讲解。
属性驱动是指在 Action 中通过字段属性进行与页面之间的数据传递,通常使用时会包括两种情况:一种是与基本数据类型的属性对应,另一种是直接使用域对象。
在 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,这两个字段分别用于对应页面上的用户名和密码这两个表单域。
在基本数据类型字段驱动方式中,如果传入的数据很多,那么 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 所示。
- <%@ 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/>
- 密 码:<input type="password" name="password"/><br/>
- <input type="reset" value="重置"/>
- <input type="submit" value="登录"/>
- </form>
- </div>
- </body>
- </html>
- <%@ 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>
- <%@ 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(一个对应表单提交的数据,一个用于持久层对象)。
总之,属性驱动的方法和模型驱动的方法各有优缺点,在实际开发中,需要根据项目实际情况选择使用哪种驱动方式。