在 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(一个对应表单提交的数据,一个用于持久层对象)。
总之,属性驱动的方法和模型驱动的方法各有优缺点,在实际开发中,需要根据项目实际情况选择使用哪种驱动方式。