一、Struts2访问Servlet的API
前面已经对Struts2的流程执行完成了，但是如果表单中有参数如何进行接收？又或者我们需要向页面保存一些数据，又要如何完成呢？我们可以通过学习Struts2访问Servlet的API来实现这样的功能。
在Struts2中，Action并没有直接和Servlet API进行耦合，也就是说在Struts2的Action中不能直接访问Servlet API。虽然Struts2中的Action访问Servlet API麻烦一些，但是这却是Struts2中Action的重要改良之一，方便Action进行单元测试。
尽管Action和Servlet API解耦会带来很多好处，然而在Action中完全不访问Servlet API几乎是不可能的，在实现业务逻辑时，经常要访问Servlet中的对象，如session、request和application等。在Struts2中，访问Servlet API有3种方法，具体如下：
1.1 通过ActionContext类访问（推荐）
Struts2框架提供了ActionContext类来访问Servlet API，ActionContext是Action执行的上下文对象，在ActionContext中保存了Action执行所需要的所有对象，包括parameters，request，session，application等。下面列举ActionContext类访问Servlet API的几个常用方法，具体如表所示：
列举的是ActionContext类访问Servlet API的常用方法，要访问Servlet API，可以通过如下方式进行，具体示例代码如下：
ActionContext context = ActionContext.getContext(); context.put("name", "张三"); context.getApplication().put("name", "张三"); context.getSession().put("name", "张三");
在上述示例代码中，通过ActionContext类中的方法调用，分别在request、application和session中放入了(“name”, “张三”)对。可以看到，通过ActionContext类可以非常简单地访问JSP内置对象的属性。
为了更好地掌握如何通过ActionContext类来访问Servlet API，接下来通过一个具体的案例来演示ActionContext的使用。
（1）创建一个web工程，在WebContent目录下编写一个简单的登录页面form.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <!-- 测试表单提交数据 --> <form action="${pageContext.request.contextPath }/userForm.action" method="post"> username:<input type="text" name="username" /><br/> password:<input type="password" name="password" /><br/> <input type="submit" value="提交" /> </form></body> </html>
在该页面中，编写了用户名和密码输入框和一个登录提交按钮。
（3）在src目录下创建struts.xml文件
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"> <struts> <!-- 配置一个包：package --> <package name="demo" namespace="/" extends="struts-default"> <!-- action获取表单提交数据 --> <action name="userForm" class="cn.itcast.action.UserFormAction"> <result name="success">/show.jsp</result> </action> </package> </struts>
（4）创建UserFormAction类进行业务处理
public class UserFormAction extends ActionSupport{ @Override public String execute() throws Exception { // 接收表单参数 // 使用ActionContext对象 ActionContext actionContext = ActionContext.getContext(); // 接收参数 Map<String, Object> map = actionContext.getParameters(); for(String key:map.keySet()){ String[] value = (String[]) map.get(key); System.out.println(key+":"+Arrays.toString(value)); } // 向request中存入数据 actionContext.put("requestName", "张三"); // 向session中存入数据 actionContext.getSession().put("sessionName", "李四"); // 向application中存入数据 actionContext.getApplication().put("applicationName", "王五"); return “success"; } }
（5）在WebContent目录下编写show.jsp，用来显示Action传递到页面的数据
<%@ 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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <h1>获取数据</h1> ${requestName } ${sessionName } ${applicationName } </body> </html>
1.2 通过特定接口访问
Struts2框架提供了ActionContext类来访问Servlet API，虽然这种方法可以访问Servlet API，但是无法直接获得Servlet API实例。为了在Action中直接访问Servlet API，Struts2还提供了一系列接口，具体如下：
- ServletRequestAware：实现该接口的Action可以直接访问Web应用的HttpServletRequest实例。
- ServletResponseAware：实现该接口的Action可以直接访问Web应用的HttpServletResponse实例。
- SessionAware：实现该接口的Action可以直接访问Web应用的HttpSession实例。
- ServletContextAware：实现该接口的Action可以直接访问Web应用的ServletContext实例。
下面以ServletRequestAware为例，讲解如何在Action中访问HttpServletRequest实例。
(1)修改UserFormAction
public class UserFormAction extends ActionSupport implements ServletRequestAware{ HttpServletRequest request; @Override public void setServletRequest(HttpServletRequest request) { this.request = request; } @Override public String execute() throws Exception { // 接收表单参数 // 使用ActionContext对象 ActionContext actionContext = ActionContext.getContext(); // 接收参数 Map<String, Object> map = actionContext.getParameters(); for(String key:map.keySet()){ String[] value = (String[]) map.get(key); System.out.println(key+":"+Arrays.toString(value)); } //----------------------------------------------------- // 向request中存入数据 actionContext.put("requestName", "张三"); // 向session中存入数据 actionContext.getSession().put("sessionName", "李四"); // 向application中存入数据 actionContext.getApplication().put("applicationName", "王五"); //------------------------------------------------------ request.setAttribute("message", "通过ServletRequestAware接口实现了访问Servlet API"); return "success"; } }
在上述文件中，自定义的UserFormAction类实现了Action的ServletRequestAware接口。需要注意的是，UserFormAction类中必须实现setServletRequest()方法和execute()方法，通过setServletRequest()方法，可以得到HttpServletRequest的实例，这是在调用execute()方法或者其他自定义的方法之前就调用的，然后在execute()方法中，就可以访问HttpServletRequest的属性内容了。
（2）在show.jsp展示页面中添加EL表达式访问存放在request对象中键为message的值
<div align="center">${requestScope.message }</div>
（3）重新发布struts2-01项目，在浏览器地址栏中输入http://localhost:8080/struts2-01/form.jsp，成功访问后可以看出，使用ServletRequestAware接口顺利访问了Servlet API。
1.3 通过ServletActionContext类访问
为了直接访问Servlet API，Struts2框架还提供了ServletActionContext类，该类包含了几个常用的静态方法，具体如下：
- static HttpServletRequest getRequest()：获取Web应用的HttpServletRequest对象
- static HttpServletResponse getResponse()：获取Web应用的HttpServletResponse对象
- static ServletContext getServletContext()：获取Web应用的ServletContext对象
- static PageContext getPageContext()：获取Web应用的PageContext对象
接下来，讲解如何通过ServletActionContext访问Servlet API。
(1)修改UserFormAction
public class UserFormAction extends ActionSupport { @Override public String execute() throws Exception { // 接收表单参数 HttpServletRequest request = ServletActionContext.getRequest(); // 接收参数 Map<String, String[]> map = request.getParameterMap(); for (String key : map.keySet()) { String[] value = (String[]) map.get(key); System.out.println(key + ":" + Arrays.toString(value)); } // 向request中存入数据 request.setAttribute("requestName", "张三"); // 向session中存入数据 request.getSession().setAttribute("sessionName", "李四"); // 向application中存入数据 ServletActionContext.getServletContext().setAttribute("applicationName", "王五"); return "success"; } }
（2）重新运行struts2-01项目，在浏览器地址栏中输入http://localhost:8080/struts2-01/form.jsp。
从以上内容可以看出，借助于ServletActionContext类的帮助，开发者也可以在Action中直接访问Servlet API，避免了Action类实现ServletRequestAware、ServletResponseAware、SessionAware和ServletContextAware等XxxAware接口。虽然如此，该Action依然与Servlet API直接耦合，一样不利于程序解耦。综上三种访问Servlet API的方式，建议在开发中优先使用ActionContext，以避免和Servlet API耦合。
Servlet的API已经可以访问了，那么在页面跳转的时候我们会发现其实Struts2默认使用的都是转发，那如果我们要使用重定向，应该怎么办呢？接下来我们来看下结果页面的配置。
二、结果页面的配置
在struts.xml文件中，result的配置非常简单，使用<result>元素来配置result逻辑视图与物理视图之间的映射，<result>元素可以有name和type属性，但这两种属性都不是必选的。
- name属性：指定逻辑视图的名称，默认值为success。
- type属性：指定返回的视图资源的类型，不同的类型代表不同的结果输出，默认值是dispatcher。
struts.xml文件中的<result>元素配置代码如下所示：
<action name="demo" class="cn.itcast.action.result.DemoAction"> <result name="success" type="dispatcher">/demo.jsp</result> </action>
在上述配置中，使用了<result>元素的name、type属性。其中，为Action配置了name为success的result映射，该映射的值可以是JSP页面，也可以是一个Action的name值。用type属性指定了该result的结果类型为dispatcher，它也是默认的结果类型。
在结果页面的配置中，Struts2有两种配置的方式，一种称之为全局结果页面，一种称之为局部结果页面。全局结果是指在这个包下的所有返回相同字符串的值，都可以向这个页面来进行跳转。局部结果是指在某个Action中返回的字符串的值，会向这个页面跳转。
2.1 全局结果页面
全局结果页面是指在同一个包下面配置的Action中返回相同的字符串的值，都可以跳转到该页面。需要通过<global-results>进行配置。
下面通过一个简单的案例来演示全局结果页面的使用。
（1）创建两个Action类——CustomerAction类和OrdersAction类，执行默认的execute()方法，默认方法都返回success，如下所示：
- CustomerAction
public class CustomerAction extends ActionSupport { @Override public String execute() throws Exception { return "success"; } }
- OrdersAction
public class OrdersAction extends ActionSupport { @Override public String execute() throws Exception { return "success"; } }
(2)在struts.xml文件对以上两个Action类进行配置
<action name="customer" class="cn.itcast.action.result.CustomerAction"> <result name="success">/form.jsp</result> </action> <action name="orders" class="cn.itcast.action.result.OrdersAction"> <result name="success">/form.jsp</result> </action>
上面配置好了两个action，两个action都是执行execute()方法，两个action的execute()方法都返回success，返回之后都到form.jsp这个页面中，这样写功能没有问题，但造成有很多重复的配置。所以可使用全局结果页面进行配置，在action标签所在的package标签里面使用global-results进行配置。
<!-- 配置全局结果页面 --> <global-results> <result name="success">/form.jsp</result> </global-results> <action name="customer" class="cn.itcast.action.result.CustomerAction"> <!-- <result name="success">/form.jsp</result> --> </action> <action name="orders" class="cn.itcast.action.result.OrdersAction"> <!-- <result name="success">/form.jsp</result> --> </action>
2.2 局部结果页面
局部结果页面是指在某个Action中根据该字符串的值进行页面的跳转。只对这个Action有效。
<action name="demo" class="cn.itcast.action.result.DemoAction"> <result name="success" type="dispatcher">/demo.jsp</result> </action>
注意：如果配置了全局结果页面，也配置了局部结果页面，那么最终以局部结果页面为准。
2.3 result标签的type属性
在Struts2中，当框架调用Action对请求进行处理后，就要向用户呈现一个结果视图。在Struts2中，预定义了多种ResultType，其实就是定义了多种展示结果的技术。
一个结果类型就是实现了com.opensymphony.xwork2.Result接口的类，Struts2把内置的<result-type>都放在struts-default包中，struts-default包就是配置包的父包，这个包定义在struts2-core-2.3.24.jar包中的根目录下的struts-default.xml文件中，可以找到相关的<result-type>的定义。
每个<result-type>元素都是一种视图技术或者跳转方式的封装，其中的name属性指出在<result>元素中如何引用这种视图技术或者跳转方式，对应着<result>元素的type属性。Struts2中预定义的ResultType如表所示：
其中红色的几个值比较常用，需要重点记忆。其他的了解即可。 下面我们演示这四个属性的配置：
- dispatcher（转发）
<action name="Demo1Action" class="cn.itcast.action.Demo1Action" method="execute" > <result name="success" type="dispatcher" >/hello.jsp</result> </action>
- redirect（重定向）
<action name="Demo2Action" class="cn.itcast.action.Demo2Action" method="execute" > <result name="success" type="redirect" >/hello.jsp</result> </action>
- chain（转发到Action）
<action name="Demo3Action" class="cn.itcast.action.Demo3Action" method="execute" > <result name="success" type="chain"> <!-- action的名字 --> <param name="actionName">Demo1Action</param> <!-- action所在的命名空间 --> <param name="namespace">/</param> </result> </action>
- redirectAction（重定向到Action）
<action name="Demo4Action" class="cn.itcast.action.Demo4Action" method="execute" > <result name="success" type="redirectAction"> <!-- action的名字 --> <param name="actionName">Demo1Action</param> <!-- action所在的命名空间 --> <param name="namespace">/</param> </result> </action>
到这我们已经了解了Struts2的结果页面的配置了，也知道如何接收数据了，但是接收过来的数据，往往需要进行封装才会向业务层进行传递，那么作为一个框架，如果连这点功能都没有，那就太不像是一个“框架”了，那么在Struts2中提供了对于数据封装的几种方式。接下来我们就来学习一下。
三、Struts2的数据封装
在很多的实际开发中的场景中，页面提交请求参数到Action，在Action中接收参数并且对请求参数需要进行数据的封装。封装到一个JavaBean中，然后将JavaBean传递给业务层。那么这些操作Struts2已经替我们都想好了。Struts2将数据的封装分成两大类，一类被称为是属性驱动，一类被称为是模型驱动。在讲这两种方式之前，我们来使用传统方式封装数据到JavaBean对象中。
【使用传统方式封装数据到JavaBean对象】
（1）创建一个form.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="${pageContext.request.contextPath }/data1.action" method="post"> username:<input type="text" name="username" /><br/> password:<input type="password" name="password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）创建一个封装数据的JavaBean——User.java
public class User { private String username; private String password; get/set... }
（3）创建一个Action
public class DataAction extends ActionSupport { @Override public String execute() throws Exception { // 1.获取表单提交的数据 HttpServletRequest request = ServletActionContext.getRequest(); String username = request.getParameter("username"); String password = request.getParameter("password"); // 2.把表单提交的数据封装到实体类里面去 User user = new User(); user.setUsername(username); user.setPassword(password); System.out.println(user); return NONE; } }
（4）在struts.xml中配置该action
3.1 属性驱动
在Struts2中，可以直接在Action中定义各种Java基本数据类型的字段，使这些字段与表单数据相对应，并利用这些字段进行数据传递。
【属性驱动方式一：提供属性的set方法的方式】
（1）编写form.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="${pageContext.request.contextPath }/data2.action" method="post"> username:<input type="text" name="username" /><br/> password:<input type="password" name="password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）编写Action类
/** * 参数封装的属性驱动的方式一:提供属性的set方法 */ public class ActionDemo1 extends ActionSupport{ // 接收参数 private String username; private String password; // 提供属性的set方法 public void setUsername(String username) { this.username = username; } public void setPassword(String password) { this.password = password; } public String execute() { System.out.println(username); System.out.println(password); return null; } }
注意：在Action类里面定义成员变量时，成员变量的名称要和表单输入项的name属性值一样。
（3）在struts.xml核心配置文件中配置好该Action
<action name="userForm" class="cn.itcast.action.ActionDemo1"></action>
以上这种方式需要通过在Action中定义属性，并且提供属性的set方法来完成。这种方式只需要提供set方法即可。但若需要传入的数据很多的话，那么Action的属性也会变得很多。再加上属性有对应的getter/setter方法，Action类的代码会很庞大，在Action里编写业务的代码时，会使Action非常臃肿，不够简洁。那么要怎样解决这个问题呢？
把属性和相应的getter/setter方法从Action里提取出来，单独作为一个值对象，这个对象就是用来封装这些数据的，在相应的Action里直接使用这个对象，而且可以在对个Action里使用。采用这种方式，一般以JavaBean来实现，所封装的属性和表单的属性一一对应，JavaBean将成为数据传递的载体。
【属性驱动方式二：页面提供表达式方式】
（1）修改form.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="${pageContext.request.contextPath }/userForm.action" method="post"> username:<input type="text" name="user.username" /><br/> password:<input type="password" name="user.password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）编写Action
public class ActionDemo2 extends ActionSupport{ private User user; // 必须提供对象的get方法 public User getUser() { return user; } public void setUser(User user) { this.user = user; } @Override public String execute() throws Exception { System.out.println(user); return null; } }
以上这种方式需要提供对user变量的get方法，如果没有提供get方法，在Struts2的底层就没有办法获得到该对象，那么在user中只会有一个属性被封装进去，而其他的属性都是null。
3.2 模型驱动
在Struts2中，Action处理请求参数还有另外一种方式，叫做模型驱动(ModelDriven)。通过实现ModelDriven接口来接收请求参数，Action类必须实现ModelDriven接口，并且要重写getModel()方法，这个方法返回的就是Action所使用的数据模型对象。
模型驱动方式通过JavaBean模型进行数据传递，只要是普通的JavaBean，就可以充当模型部分。采用这种方式，JavaBean所封装的属性与表单的属性一一对应，JavaBean将成为数据传递的载体。
（1）编写form.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <!-- 数据封装的方式三:使用模型驱动方式 --> <form action="${pageContext.request.contextPath }/actionDemo3.action" method="post"> username:<input type="text" name="username" /><br/> password:<input type="password" name="password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）编写Action
public class ActionDemo3 extends ActionSupport implements ModelDriven<User>{ // 手动创建对象 private User user = new User(); @Override public User getModel() { return user; } public String execute() { System.out.println(user); return NONE; } }
注意：使用模型驱动这种方式处理请求参数的前提条件是：表单输入项的name属性值要和实体类里面的属性名称一致。
（3）在struts.xml中配置该action
<action name="actionDemo3" class="cn.itcast.action.ActionDemo3"></action>
【属性驱动和模型驱动的区别】
- 使用属性封装，只能把数据封装到action里面的属性中，不能直接把数据封装到对象里面。
- 使用模型驱动封装，可以直接把表单提交数据封装到实体类对象里面。
到这里我们已经能够将数据封装到一个Java对象中了，大部分我们会优先使用模型驱动的方式，因为Struts2内部有很多结果是围绕模型驱动设计的。但如果页面向多个对象中封装，那么就需要使用属性驱动的方式二了。这些都是向某个对象中封装数据，那么如果Action中需要一个对象的集合呢？又应该如何进行数据的封装呢？那么接下来我们来了解一下Struts2中复杂类型数据的封装。
3.3 封装集合类型的数据
在实际的开发中，有些时候我们需要批量插入用户或者批量插入其他对象，在Action中需要接收到这多个Action中封装的对象，然后传递给业务层。那么这个时候就需要将表单的数据封装到集合中。一般我们通常使用的集合无非是List或者Map集合。下面就以这两种集合进行数据的封装的示例演示。
3.3.1 封装到List集合中
（1）编写list.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="${pageContext.request.contextPath }/list.action" method="post"> <!-- List集合的遍历有4种方式，一种最原始的方式就是普通的for循环。 list[0]：List集合中的第一个元素，而List集合中的第一个元素是User对象的形式。 list[0].username：List集合中的第一个User对象里面的username属性。 --> username:<input type="text" name="list[0].username" /> password:<input type="password" name="list[0].password" /><br/> username:<input type="text" name="list[1].username" /> password:<input type="password" name="list[1].password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）创建ListAction
public class ListAction extends ActionSupport { private List<User> list; public List<User> getList() { return list; } public void setList(List<User> list) { this.list = list; } @Override public String execute() throws Exception { for (User user : list) { System.out.println(user); } return NONE; } }
List集合有下标，所以可以通过list[0]，list[1]。那么如果是Map集合又应该如何进行封装呢？那么接下来我们就来看如何将数据封装到Map集合中。
3.3.2 封装数据到Map集合中
（1）编写map.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> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> <form action="${pageContext.request.contextPath }/map.action" method="post"> <!-- map['one']:设置map集合的key的值为one，得到value值是User对象 1.设置map集合的key的值为one 2.根据key得到value，value是User对象，然后向User对象里面设置值 --> username:<input type="text" name="map['one'].username" /> password:<input type="password" name="map['one'].password" /><br/> username:<input type="text" name="map['two'].username" /> password:<input type="password" name="map['two'].password" /><br/> <input type="submit" value="提交" /> </form> </body> </html>
（2）编写Action
public class MapAction extends ActionSupport { private Map<String, User> map; public Map<String, User> getMap() { return map; } public void setMap(Map<String, User> map) { this.map = map; } @Override public String execute() throws Exception { for (String key : map.keySet()) { User user = map.get(key); System.out.println(key + ":" + user); } return NONE; } }
控制台输出结果为：
到这儿，数据已经可以进行封装了。