Struts2——开发Action

一、Action开发的三种方式

参考：https://mp.weixin.qq.com/s/6YLd8CwsieXOht8cf_R-LQ

1.1 继承ActionSupport类

在Action类中，需要用到数据校验等（Struts已经帮我们实现的功能），就继承ActionSupport类。

1.2 实现Action接口

不推荐。因为ActionSuppot也实现了Action接口。

1.3 不继承任何类、不实现任何接口

它就是一个普通的Java类。

public class PrivilegeAction  {
    public String login() {
        System.out.println("我是普通的javaAction，不继承任何的类、不实现任何的接口");
        return "success";
    }
}

<struts>
<package name="privilige" extends="struts-default">
    <action name="login" class="privilegeaction.PrivilegeAction" method="login">
        <result name="success">/index.jsp</result>
    </action>
</package>
</struts>

注意：若使用到了Struts2一些特用的功能，就需要继承ActionSupport类。

二、请求数据的封装

2.1 提出问题

Servlet作用步骤
1、得到web层的数据、封装数据
2、调用service层的逻辑业务代码
3、将数据保存在域对象中，跳转到对应的JSP页面
域对象：request、response、Session、application之类的对象。
提出问题：在struts中，自己编写的Action类是没有域对象的。那么，如何得到web层的数据、再将数据存到域对象中的呢？
解决问题：在struts中，Struts预先帮我们完成了对数据封装的功能，它是通过params拦截器来实现数据封装的。

<interceptor name="params" class="com.opensymphony.xwork2.interceptor.ParametersInterceptor"/>

2.2 解决问题

2.2.1 向后端传递数据

register.jsp
基本信息

<form action="${pageContext.request.contextPath}/date01" method="post">
    用户名：<input type="text" name="username"><br>
    密码：<input type="text" name="psd"><br>
    年龄：<input type="text" name="age"><br>
    生日：<input type="text" name="birthday"><br>
    <input type="submit" value="注册"><br>
</form>

对象
在JSP页面，提交的name要写成user.username之类的。

<form action="${pageContext.request.contextPath}/register" method="post">
    用户名：<input type="text" name="user.username"><br>
    密码：<input type="text" name="user.psd"><br>
    年龄：<input type="text" name="user.age"><br>
    生日：<input type="text" name="user.birthday"><br>
    <input type="submit" value="注册"><br>
</form>

2.2.2 后端接收数据

Action封装基本信息
在Action设置与JSP页面相同的属性，并为它们编写setter方法。
PrivilegeAction.java

private String username;
private String psd;
private int  age;
private Date birthday;
// 此处省略setter/getter方法。

Action封装对象
1、创建一个User类，基本的信息和JSP页面是相同的。
User.java

public class User {

    private String username;
    private String psd;
    private int  age;
    private Date birthday;
	// 此处省略setter/getter方法。
}

2、在Action中定义User对象出来，并给出setter和getter方法。
PrivilegeAction.java

public class PrivilegeAction extends ActionSupport {
    private User user;
	// 此处省略setter/getter方法。
    public String register() {
        System.out.println(user.getUsername());
        System.out.println(user.getPsd());
        System.out.println(user.getAge());
        System.out.println(user.getBirthday());
        return "success";
    }
}

三、得到域对象

3.1 通过ServletActionContext获取

通过ServletActionContext得到Servlet API。
javax.servlet.ServletContext
由于每个用户拥有一个Action对象，那么底层为了维护用户拿到的是当前线程的request等对象，使用ThreadLocal来维护当前线程下的request、response等对象。

ServletContext context = ServletActionContext.getServletContext();
HttpServletRequest request = ServletActionContext.getRequest();
HttpSession session = request.getSession();
HttpServletResponse response = ServletActionContext.getResponse();

3.2 通过ActionContext获取

通过ActionContext类来得到request、response、session、application被Struts封装的Map集合。

//得到ActionContext 对象
ActionContext context = ActionContext.getContext();
Map<String, Object> session = context.getSession();
Map<String, Object> application = context.getApplication();
Map<String, Object> request = context.getContextMap();

3.3 通过实现Aware接口获取

当web容器发现该Action实现了Aware接口，会把相对应的资源通过Aware接口注射进去，实际上就是一种IOC。
Aware实际就是一种拦截器，拦截代码在执行Action之前执行、将资源注射到Action中。
实现SessionAware, RequestAware, ApplicationAware接口，它就要在程序中实现三个方法。

private Map<String, Object> request;
private Map<String, Object> session;
private Map<String, Object> application;
@Override
public void setApplication(Map<String, Object> map) {
	this.application = map;
}
@Override
public void setRequest(Map<String, Object> map) {
	this.request = map;
}
@Override
public void setSession(Map<String, Object> map) {
	this.session = map;
}

3.4 三种方法的选择

方法	含义
ServletActionContext	需要导入Servlet的包，与Struts耦合了
ActionContext	只能在业务方法中使用ActionContext类得到对应的Map对象，若有多个方法，则每个方法都需要写类似的代码
xxxAware	可以在类上定义成员变量，以至于整个类都能使用。但是需要实现类、实现对应的方法

适用场景
1、需要使用到对象的其他方法，类似getContextPath()之类的，那么只能使用ServletActionContext
2、平常的开发，使用ActionContext【获取简单，没有耦合】
3、开发自己的BaseAction时，使用它。

四、日期转换问题

提出问题：yyyy-MM-dd是Struts直接支持的日期格式，想让其也支持yyyyMMdd，yyyy年MM月dd日这样的日期格式。
解决问题：
1、编写自定义转换器类。
2、告诉Struts我们写了转换器类。
3、Struts根据对应的格式进行自动封装。

4.1 自定义转换器类

想要编写自定义转换器类，都是实现StrutsTypeConverter类的。

public class MyConvter extends StrutsTypeConverter {
    //需求，当Struts自动封装数据时，也支持yyyyMMdd,yyyy年MM月dd日等格式的支持\
    SimpleDateFormat[] format = {new SimpleDateFormat("yyyy-MM-dd"), new SimpleDateFormat("yyyyMMdd"), new SimpleDateFormat("yyyy年MM月dd日")};
    /**
     * 把String转换为指定的类型 【String To Date】
     * @param map   当前上下文环境
     * @param strings  jsp表单提交的字符串的值
     * @param aClass   要转换为的目标类型
     */
    @Override
    public Object convertFromString(Map map, String[] strings, Class aClass) {
        //判断是否有值
        if (strings == null) {
            return null;
        }
        //判断是否是日期类型的
        if (Date.class != aClass) {
            return null;
        }
        //遍历循环
        for (SimpleDateFormat dateFormat : format) {
            try {            
                dateFormat.parse(strings[0]);//解析传递进来的第一个就行啦
            } catch (ParseException e) {             
                continue;//如果格式不对，那么就跳出当前的循环
            }
        }
        return null;
    }
    @Override
    public String convertToString(Map map, Object o) {
        return null;
    }
}

4.2 告诉Struts，我写了转换器类

4.2.1 全局转换器

作用范围：整个项目有效。
步骤：
1、在src目录下创建一个名为xwork-conversion.properties的文件。
2、配置文件的内容：需要转换的类类型=转换器类的全名
如：java.util.Date=qwer.MyConvter

4.2.2 局部转换器类

作用范围：当前包下的Action类有效。
步骤：
1、在当前的Action包下创建名为Action名-conversion.properties的文件。
2、文件的内容为：需要转换的字段【如果是JavaBean里的字段，需要写上JavaBean的】=转换器类的全名
如：user.birthday=qwer.MyConvter。

4.3 错误提示页面

目的：发生了日期转换的异常时，给出用户更友好的提示。
在struts.xml文件中配置：如果返回的是input视图，那么跳转到我们相对应的页面上。

<result name="input">/error.jsp</result>

五、文件上传和下载

5.1 使用Struts进行文件上传

先前：使用FileUpload或者SmartUpload组件来完成文件上传的功能。但是，FileUpload组件使用起来是比较麻烦的，SmartUPload解决中文的问题也非常麻烦。
解决方案：使用Struts进行文件上传。Struts内部还是使用fileUpload上传组件，但是它极大的简化了具体操作。

5.1.1 JSP页面

在注册页面上拥有两个上传文件控件。

<form action="${pageContext.request.contextPath}/register" method="post" enctype="multipart/form-data">
    <input type="file" name="photo"><br>
    <input type="file" name="photo1"><br>
    <input type="submit" value="注册"><br>
</form>

5.1.2 Action

得到相对应的File对象、上传文件名称、上传文件的类型。

package fileupload;
import java.io.File;
public class FileUploadAction {
    //上传文件对应的File对象
    private File photo;
    private File photo1;
    //得到上传文件的名称
    private String photoFileName;
    private String photo1FileName;
    //得到上传文件的类型
    private String photoContentType;
    private String photo1ContentType;
    //给出相对应的setter方法
    public String register() throws IOException {
        //得到上传的路径
        String path = ServletActionContext.getServletContext().getRealPath("upload");
        System.out.println(path);
        //创建文件对象
        File destFile = new File(path,photoFileName);
        //调用工具类方法，将文件拷贝过去
        FileUtils.copyFile(photo, destFile);
        return "success";
    }
}

5.2 使用Struts进行文件下载

先前：通过设置request消息头来实现文件下载的。
Struts：请求服务器处理都是通过Action类来完成的，但是Action类的业务方法都是返回字符串。
因此，Struts提供< result type=“stream”>节点。通过stream来配置相对应的信息，从而实现下载！

5.2.1 JSP页面

<c:if test="${files==null}">
    对不起，没有下载的页面
</c:if>
<c:if test="${files!=null}">
    <table border="1px">
        <tr>
            <td>编号</td>
            <td>文件名称</td>
            <td>操作</td>
        </tr>
        <c:forEach items="${files}" varStatus="file" var="fileName">
            <tr>
                <td>${file.count}</td>
                <%--如果直接写fileName，输出的名字带有路径，使用EL方法库来截取--%>
                <td>${fn:substringAfter(fileName, "upload\\")}</td>
                <td>
                    <%--使用url标签来构建url，不然超链接带有中文，会出现乱码--%>
                    <c:url var="url" value="down_downLoad">
                        <c:param name="fileName">${fn:substringAfter(fileName, "upload\\")}</c:param>
                    </c:url>
                    <a href="${url}">下载</a>
                </td>
            </tr>
        </c:forEach>
    </table>
</c:if>

5.2.2 Action

public class downLoadAction {
    //列出所有可以下载的文件
    public String list() {
        //得到upload文件夹
        String path = ServletActionContext.getServletContext().getRealPath("/upload");
        //创建file对象
        File file = new File(path);
        //列出文件下所有的文件
        File[] files = file.listFiles();
        //将这些文件存到request域中
        HttpServletRequest request = ServletActionContext.getRequest();
        request.setAttribute("files", files);
        return "list";
    }
     /**
     * 访问Action的业务方法仅仅返回的是字符串。因此Struts在result节点提供了stream类型的type，
     * 指定了stream就代表着我这是要下载的...
     * <p>
     * 既然要下载文件，那么肯定需要几样东西：
     * 1、文件名
     * 2、代表文件的流
     */
    public String downLoad() {
        return "downLoad";
    }
    //得到要下载的文件名，Struts提供了自动封装的功能
    private String fileName;
    //如果文件名是中文的，那么需要手动转换，因为超链接是get方法提交
    public void setFileName(String fileName) throws UnsupportedEncodingException {
        fileName = new String(fileName.getBytes("ISO8859-1"), "UTF-8");
        this.fileName = fileName;
        System.out.println(fileName);
    }
    //得到代表下载文件流，该方法由Struts调用
    public InputStream getAttrInputStream() {
        return ServletActionContext.getServletContext().getResourceAsStream("/upload/" + fileName);
    }
    //下载时，显示的名称【如果是中文，可能会乱码，因此要URLencode】---->在Struts.xml文件中通过${}可获取
    public String getDownFileName() throws UnsupportedEncodingException {
        fileName = URLEncoder.encode(fileName, "UTF-8");
        return fileName;
    }
}

5.2.3 Struts.xml

<action name="down_*" class="fileupload.downLoadAction" method="{1}">
	<result name="{1}">/list.jsp</result>
	<result name="downLoad" type="stream">
		<!--运行下载的类型，指定为所有的二进制文件-->
		<param name="contentType">application/octet-stream</param>
		<!-- 对应的是Action中属性： 返回流的属性【其实就是getAttrInputStream()】 -->
		<param name="inputName">attrInputStream</param>
		<!-- 下载头，包括：浏览器显示的文件名 -->               <!--${}这里不是EL表达式-->
		<param name="contentDisposition">attachment;filename=${downFileName}</param>
		<!-- 缓冲区大小设置 -->
		<param name="bufferSize">1024</param>
	</result>
</action>

六、模型驱动

6.1 含义

含义：在Struts2中模型驱动就是用来封装数据的，完成数据的自动封装.。
提出问题：先前，
1、通过Sturts2的数据自动封装功能，是用params拦截器完成的。
2、使用params拦截器完成数据自动封装时，若封装的是JavaBean对象，则在web表单中就必须的name写上javaBean.属性名（name = “user.username”）。
3、因此，web层和Action层就耦合了。因为web层必须知道封装的JavaBean对象是什么，才能实现自动封装！
解决问题：模型驱动。当不知道Action层的JavaBean对象是什么，也能够完成数据自动封装！

6.2 模型驱动的实现原理

实现模型驱动功能也是由拦截器完成的。

 <interceptor name="modelDriven" class="com.opensymphony.xwork2.interceptor.ModelDrivenInterceptor"/>

拦截方法的源码

public String intercept(ActionInvocation invocation) throws Exception {	
	Object action = invocation.getAction();//得到当前要执行的Action对象
	//判断该Action对象是否实现了ModelDriven接口
	if(action instanceof ModelDriven) {
		ModelDriven modelDriven = (ModelDriven)action;	
		ValueStack stack = invocation.getStack();//获取值栈对象	
		Object model = modelDriven.getModel();//得到model的对象
		//把对象存到值栈对象中
		if(model != null) {
			stack.push(model);
		}
		if(this.refreshModelBeforeResult) {
			invocation.addPreResultListener(new ModelDrivenInterceptor.RefreshModelBeforeResult(modelDriven, model));
		}
	}
	return invocation.invoke();
}

6.3 使用数据模型驱动

6.3.1 实现ModelDriven接口

实现ModelDriven接口，重写方法。实现接口时，要封装的对象是什么，形参类型就给什么。

public class UserAction extends ActionSupport implements ModelDriven<User> {
    public String login() {
        return SUCCESS;
    }
    @Override
    public User getModel() {
        return null;
    }
}

6.3.2 对象实例化

实现ModelDriven接口，重写方法。实现接口时，要封装的对象是什么，形参类型就给什么。

public class UserAction extends ActionSupport implements ModelDriven<User> { 
    private User user = new User();//这里一定要实例化
    // setter/getter方法。
    @Override
    public User getModel() {
        return user;
    }
    @Override
    public String execute() throws Exception {
        System.out.println(user);
        return SUCCESS;
    }
}

6.3.3 JSP页面

JSP提交页面，直接写上JavaBean对象的属性就行了。不需要写上JavaBean对象的名称！

<form action="${pageContext.request.contextPath}/user_execute">
    <table border="1">
        <tr>
            <td>用户名：<input type="text" name="username"></td>
        </tr>
        <tr>
            <td> 密码：<input type="password" name="password"></td>
        </tr>
        <tr>
            <td>电话：<input type="text" name="cellphone"></td>
        </tr>
        <tr>
            <td> 邮箱：<input type="text" name="email"></td>
        </tr>
        <tr>
            <td><input type="submit" value="提交"></td>
        </tr>
    </table>
</form>