1. 前言
这个章节是Struts2框架应用最广泛的三个版块（上传下载、国际化、校验输入）之一，所以这一版块的学习还蛮重要的。
2. 具体内容
2.1Struts2文件上传
2.1.1单文件上传
本小节通过一个示例讲解Struts2如何实现单文件的上传。
（1） 先写一个选择上传单文件页面（select.jsp）
<%@ taglib prefix="s" uri="/struts-tags" %>
<%--
Created by IntelliJ IDEA.
User: mairr
Date: 17-12-7
Time: 下午9:04
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" import="java.util.*" language="java" pageEncoding="UTF-8" %>
<html>
<head>
<title>upload_test</title>
</head>
<body>
<s:form action="upload" method="post" theme="simple" enctype="multipart/form-data">
输入帐号：<s:textfield name="uid"/><br>
选择头像：<s:file name="headImage"/><br>
<s:submit value="提交"/>
<s:fielderror/>
</s:form>
</body>
</html>
如下所示的一个上传选择界面框：
（2） 当文件上传页面提交请求时，请求发送到upload.action，这是一个Struts2的Action，该Action处理上传请求，具体的UploadAction类代码如下：
package action;
import com.opensymphony.xwork2.ActionSupport;
import org.apache.commons.io.FileUtils;
import org.apache.struts2.ServletActionContext;
import java.io.File;
import java.io.IOException;
public class UploadAction extends ActionSupport {
private String uid; // 封装帐号（uid）请求参数属性
private File headImage; // 封装上传文件域属性
private String headImageContentType; // 封装上传文件类型的属性
private String headImageFileName; // 封装上传文件属性
public String getUid() {
return uid;
}
public void setUid(String uid) {
this.uid = uid;
}
public File getHeadImage() {
return headImage;
}
public void setHeadImage(File headImage) {
this.headImage = headImage;
}
public String getHeadImageContentType() {
return headImageContentType;
}
public void setHeadImageContentType(String headImageContentType) {
this.headImageContentType = headImageContentType;
}
public String getHeadImageFileName() {
return headImageFileName;
}
public void setHeadImageFileName(String headImageFileName) {
this.headImageFileName = headImageFileName;
}
public String execute() throws IOException {
// 上传文件的保存位置在“/image”,该位置在tomcat服务器的“webapps”之中
String realpath= ServletActionContext.getServletContext().getRealPath("/image");
// 声明文件目录image，如果文件名不存在就建一个呗～
File file = new File(realpath);
if(!file.exists()){
file.mkdirs();
}
// 实现文件上传，也就是做了一个方法调用～
FileUtils.copyFile(headImage,new File(file,headImageFileName));
return SUCCESS;
}
}
需要注意的是，上面的Action除了包含两个表单域的name属性外，还包含headImageContentType和headImageFileName两个属性，这两个属性分别能用于封装上传文件的文件类型、上传文件的文件名。可以这样认为：如果表单中包含一个name属性为xxx的文件域，则对应的Action需要使用3个属性来封装文件域信息：
- 类型为java.io.File的xxx属性来封装文件域的信息;
- 类型为String的xxxFileName属性封装了该文件域对应的文本内容;
- 类型为String的xxxContentType属性封装了该文件域对应的文件类型。
所以，在Action的execute方法中，可以直接通过这3个属性获取上传文件的文件名、文件类型和文件内容。
（3） 接下来进行UploadAction的配置（struts.xml文件配置），具体代码如下：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<struts>
<!--指定国际化资源文件（下一章会讲到）-->
<constant name="struts.custom.i18n.resources" value="messageResource"/>
<!--设置Struts应用的解码集-->
<constant name="struts.i18n.encoding" value="utf-8"/>
<!-- --- 包配置 ---- -->
<package name="default" namespace="/" extends="struts-default">
<action name="upload" class="action.UploadAction">
<result>/uploadSuccess.jsp</result>
</action>
</package>
</struts>
（4） 最后写一个上传成功页面（uploadSuccess.jsp）
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>上传初始页</title>
</head>
<body>
上传成功!<br>
<!--输入表单里的用户帐号属性-->
用户帐号：<s:property value="uid"/><br>
<!--根据上传文件名字,显示上传头像-->
您的头像：<img src="<s:property value="'image/' + headImageFileName"/> " alt="图像无法显示"/>
</body>
</html>
上传过程图：
（a）选择图片
（b）确认选择
（c）提交之后，显示上传成功
2.1.2 拦截器实现文件的过滤
Struts2提供了一个名为fileUpload拦截器，通过配置该拦截器可以轻松地实现文件过滤。为了让fileUpload拦截器起作用，只需要在处理文件上传的Action中配置该拦截器引用即可。
配置fileUpload拦截器时可以指定如下两个参数：
- allowTypes：该参数指定允许上传文件的类型，多个文件类型之间以英文逗号隔开;
- maximumSize：该参数指定允许上传文件的大小，单位是字节。
当文件过滤失败后，系统自动转入input逻辑视图，因此必须为Action配置名为input的逻辑视图。
（1） 通过拦截器来实现文件过滤的struts.xml配置文件如下：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<struts>
<!--指定国际化资源文件（下一讲会讲到）-->
<constant name="struts.custom.i18n.resources" value="messageResource"/>
<!--设置Struts应用的解码集-->
<constant name="struts.i18n.encoding" value="utf-8"/>
<!--package中加入拦截器-->
<package name="default" namespace="/" extends="struts-default">
<interceptors>
<!--配置拦截器栈(在拦截器章节有讲述)-->
<interceptor-stack name="myStack">
<!--配置fileUpload拦截器-->
<interceptor-ref name="fileUpload">
<!--配置允许上传文件的类型（此处要注意的是png图片在ie浏览器中是image/x-png类型）-->
<param name="allowedTypes">image/x-png,image/bmp,image/gif,image/jpeg,image/jpg</param>
<!--配置允许上传文件大小拦截器，单位是字节（2的16次幂=65536（64k））-->
<param name="maximumSize">65536</param>
</interceptor-ref>
<interceptor-ref name="defaultStack"/>
</interceptor-stack>
</interceptors>
<action name="upload" class="action.UploadAction">
<!--使用拦截器栈-->
<interceptor-ref name="myStack"/>
<result>/uploadSuccess.jsp</result>
<!--过滤失败，系统会转入input逻辑视图，这里配置其返回选择界面-->
<result name="input">/select.jsp</result>
</action>
</package>
</struts>
格式不对和容量大于64kb会上传失败，直接返回重新选择的界面。如果上传失败，系统需要回应上传失败信息。因此，需要在文件上传页selectFile.jsp页面中加上“<s:filederror/>”------->(我直接加到了selectFile.jsp代码中，你可以回看上面)
（a） 文件格式不对
------(提交之后)------->
（b） 文件大小超过了限额
-------（提交之后）----->
2.1.3 文件上传的常量配置
上传文件时，系统默认使用web服务器的工作路径作为临时路径。为了避免文件上传时候使用Web服务器的工作路径作为临时路径，则应该设置struts.multipart.saveDir常量。该常量指定上传文件的临时保存路径。该常量配置示例如下：
<constant name="struts.multipart.saveDir" value="HOME/....(写上路径)..."/>
此外，还有一个文件上传的常量struts.multipart.maxSize。该常量指定struts.mutipart.maxSize。该常量指定在struts2文件上传中整个请求内容所允许的最大字节数，默认为2097152（即2MB）。该常量配置示例如下：
<constant name="struts.multipart.maxSize" value="209971520"/>
2.1.4 Struts2多文件上传
在Struts2应用中，如果一个页面有多个文件域需要实现上传，则可以为每个文件域提供三个属性，分别封装该文件域对应的文件名、文件类型和文件内容。多文件上传与单文件上传没有什么区别，仅仅是利用数组同时上传多个文件的方式。
在处理多文件上传时，要注意改变的是，在Action类中，需要使用三个数组分别封装文件名、文件类型和文件内容。
// 实现单文件上传代码如下：
FileUtils.copyFile(headImage,new File(file,headImageFileName));
// 实现多文件下载代码如下：
for(int i = 0; i < headImage.length(); i++){
File uploadImage = headImage[i];
FileUtils.copyFile(uploadImage,new File(file,headImageFileName[i]));
}
2.2 Struts2文件下载
利用Struts2来处理文件的下载的问题时，能够解决下载文件的文件名为中英文等等都不出现乱码。此外，还能够在用户下载之前进行检查，判断用户是否有足够的权限来下载该文件等。下面用一个示例来讲解文件的下载：
（1） 先写一个下载页面：(index.jsp)
<%--
Created by IntelliJ IDEA.
User: mairr
Date: 17-12-9
Time: 下午2:20
To change this template use File | Settings | File Templates.
--%>
<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
<html>
<head>
<title>test_download</title>
</head>
<body>
请下载中文课件：<a href="downLoad.action?downPath=第一章节.doc">中</a><br>
请下载英文课件：<a href="downLoad.action?downPath=chapter01.doc">英</a><br>
</body>
</html>
（2） 在Struts2框架文件下载Action类中，需要提供一个返回InputStream流方法，该输入流代表了被下载文件的入口。该Action类代码如下所示：（DownLoadAction.java）
package action;
import com.opensymphony.xwork2.ActionSupport;
import org.apache.struts2.ServletActionContext;
import util.MyUtil;
import java.io.InputStream;
import java.io.UnsupportedEncodingException;
public class DownLoadAction extends ActionSupport{
private String downPath; // 下载时的文件名
private String contentType; // 保存文件类型
private String filename; // 保存时的文件名
public String getContentType() {
return contentType;
}
public void setContentType(String contentType) {
this.contentType = contentType;
}
public String getFilename() {
return filename;
}
public void setFilename(String filename) {
this.filename = filename;
}
public String getDownPath() {
return downPath;
}
public void setDownPath(String downPath) {
try {
// 解决下载时候的中文文件乱码问题
downPath = new String(downPath.getBytes("ISO-8859-1"),"UTF-8");
}catch (UnsupportedEncodingException e){
e.printStackTrace();
}
this.downPath = downPath;
}
/*
*下载用的Action返回一个InputString实例，该方法对应Action配置
*里面的result的inputName参数，值为inputString
*
*/
public InputStream getInputString(){
return ServletActionContext.getServletContext().getResourceAsStream(downPath);
}
public String execute(){
// 下载保存时的文件名和被下载的文件名一样
filename = downPath;
// 下载的文件路径，请在webapps目录下创建images
downPath = "images/" + downPath;
// 保存文件的类型
contentType = "application/x-msdownload";
/*
*对下载的文件名按照UTF-8进行编码，解决下载窗口中的中文乱码问题
* 其中,MyUtil是自己定义的一个类
*/
filename = MyUtil.toUTF8String(filename);
return SUCCESS;
}
}
(3) 在上述的Action类中定义了一个工具类MyUtil，该类中有一个静态方法toUTF8String实现对下载的文件名按照UTF-8进行编码，解决下载窗口中中文乱码的问题：（MyUtil.java）
package util;
import java.io.UnsupportedEncodingException;
public class MyUtil {
// 对下载文件按照 UTF-8 进行编码
public static String toUTF8String(String str){
StringBuffer sb = new StringBuffer();
int len = str.length();
for (int i = 0; i < len; i++)
{
// 取出字符中的每个字符
char c = str.charAt(i);
// Unicode码值在0～255之间，不做处理
if(c>=0 && c <= 255){
sb.append(c);
}else {
// 转换 UTF-8 编码
byte b[];
try{
b = Character.toString(c).getBytes("UTF-8");
}catch(UnsupportedEncodingException e){
e.printStackTrace();
b = null;
}
// 转换为%HH的字符串形式
for(int j = 0;j < b.length ; j++){
int k = b[j];
if(k < 0){
k &= 255;
}
sb.append("%" + Integer.toHexString(k).toUpperCase());
}
}
}
return sb.toString();
}
}
(4) 最后，完成Action的配置，关键是要配置一个类型为stream的结果，配置时需要指定如下四个属性：
- contentType: 指定被下载文件的文件类型;
- inputName: 指定被下载文件的入口输入流;
- contentDisposition： 指定下载的文件名;
- bufferSize： 指定下载文件时的缓冲大小。
具体代码如下：（struts.xml）
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.5//EN"
"http://struts.apache.org/dtds/struts-2.5.dtd">
<struts>
<package name="default" namespace="/" extends="struts-default">
<action name="downLoad" class="action.DownLoadAction">
<!--结果类型为String-->
<result type="stream">
<param name="contentType">${contentType}</param>
<!--默认就是inputStream,它将会指示StreamResult通过
inputName属性值的getter和setter方法，如这里就是
getInputStream()来获取下载文件的内容,意味着Action
要有这个方法
-->
<param name="inputName">inputStream</param>
<!--默认为inline（在线打开）,设置为attachment将会告诉浏览器下载
该文件,filename指定下载文件时的文件名，若未指定将会以浏览器
页面名作为文件名,如：以download.action作为文件名
-->
<param name="contentDisposition">attachment;filename=${filename}</param>
<!--指定下载文件的缓冲大小-->
<param name="bufferSize">4096</param>
</result>
</action>
</package>
(5) 最后的下载窗口：
