Struts2之文件上传下载

本篇文章主要介绍如何利用struts2进行文件的上传及下载，同时给出我在编写同时所遇到的一些问题的解决方案。

文件上传

前端页面

<!-- 引入struts标签 -->
<%@taglib prefix="s" uri="/struts-tags"%>

<!--
    使用struts中的<s:file></s:file>标签来选择文件。
    设置name属性，则提交后将传递后给后台一个name属性值(upload)的文件类型的文件。
    同时，将随同传递该文件的名字(uploadFileName)及文件类型(uploadContentType)
    表单中增加编码格式(enctype)为multipart/form-data
-->
<form action="upload" enctype="multipart/form-data" method="post">
    <s:file name="upload" label="Select File"/>
    <button type="submit">Submit</button>
</form>

struts.xml

<!-- 指定上传的文件暂时保存的位置 -->
<constant name="struts.multipart.saveDir" value="/tmp"/>
<package name="default" extends="struts-default">
    <!-- 上传文件action -->
    <action name="home">
        <result>/WEB-INF/content/home.jsp</result>
    </action>
    <action name="upload" class="com.wsy.action.UploadAction">
        <!-- 引入拦截器 -->
        <interceptor-ref name="fileUpload">
            <!-- 文件允许类型,可自行搜索查表,未指定则为默认所有类型 -->
            <param name="allowedTypes">image/jpeg,image/gif,text/plain</param>
            <!-- 文件最大大小 -->
            <param name="maximumSize">1024*1024</param>
        </interceptor-ref>
        <!-- 一定要引入defaultStack,否则将无法提交数据至后台 -->
        <interceptor-ref name="defaultStack"></interceptor-ref>
        <!-- 上传成功,返回首页 -->
        <result type="redirect">home.action</result>
        <!-- 上传不成功,设置input逻辑视图,进入报错页面 -->
        <result name="input">/WEB-INF/content/error.jsp</result>
    </action>
</package>

文件上传action

package com.wsy.action;

import java.io.*;

import org.apache.struts2.ServletActionContext;

import com.opensymphony.xwork2.ActionSupport;

public class UploadAction extends ActionSupport {
        private File upload;                // 上传的文件
        private String uploadContentType;    // 上传的文件的类型
        private String uploadFileName;        // 上传的文件的名字
        
        public File getUpload() {
            return upload;
        }

        public void setUpload(File upload) {
            this.upload = upload;
        }

        public String getUploadContentType() {
            return uploadContentType;
        }

        public void setUploadContentType(String uploadContentType) {
            this.uploadContentType = uploadContentType;
        }

        public String getUploadFileName() {
            return uploadFileName;
        }

        public void setUploadFileName(String uploadFileName) {
            this.uploadFileName = uploadFileName;
        }

        @Override
        public String execute() throws Exception
        {
            String path = ServletActionContext.getServletContext().getRealPath("/WEB-INF/uploadFiles");
            File file = new File(path);
//            创建文件保存文件夹
            if (!file.exists())
                file.mkdirs();
            FileOutputStream fos = new FileOutputStream(path + File.separator + getUploadFileName());
            FileInputStream fis = new FileInputStream(getUpload());
            byte[] buffer = new byte[1024];
            int len = 0;
            while ((len = fis.read(buffer)) > 0) {
                fos.write(buffer , 0 , len);
            }
            fis.close();
            fos.close();
            return SUCCESS;
        }
}

原理：Struts2文件上传通过将HTTP上传的数据先保存到临时文件夹（本文中为/tmp），然后使用fileUpload拦截器将文件绑定到Action的实例中，从而就能够以本地文件方式的操作浏览器上传的文件，将其保存到服务器下的特定位置。

文件下载

前端页面

<ol>
    <% 
    String[] filelist = (String[])request.getSession().getAttribute("filelist");
    if (filelist != null) {
        for (int i = 0; i < filelist.length; i++) {
    %>
    <li><a href="download.action?filename=<%=filelist[i]%>"><%=filelist[i]%></a></li>
    <%
        }
    } else {
    %>
    <li>无文件</li>
    <% } %>
</ol>

struts.xml

<package name="download" extends="struts-default">
    <!-- 下载文件action -->
    <action name="download" class="com.wsy.action.DownloadAction">
        <result name="success" type="stream">
            <param name="contentType">image/jpeg,image/gif,text/plain</param>
            <!-- 获取输入流，根据值调用相应的get方法 -->
            <param name="inputName">targetFile</param>
            <!--
                contentDisposition是文件下载的处理方式，包括内联(inline)和附件(attachment)，默认是inline。
                使用附件时这样配置：attachment;filename="文件名" 。
            -->
            <param name="contentDisposition">attachment;filename="${filename}"</param>
            <param name="bufferSizbe">1024*1024</param>
        </result>
    </action>
</package>

文件下载action

package com.wsy.action;

import java.io.InputStream;

import org.apache.struts2.ServletActionContext;
import com.opensymphony.xwork2.ActionSupport;

public class DownloadAction extends ActionSupport {
    private String filename;
    
    public String getFilename() {
        return filename;
    }

    public void setFilename(String filename) {
        this.filename = filename;
    }

    public InputStream getTargetFile() throws Exception {
        InputStream in = ServletActionContext.getServletContext().getResourceAsStream("/WEB-INF/uploadFiles/" + this.getFilename());
        return in;
    }
    
    public String execute() throws Exception {
        return SUCCESS;
    }
}

原理：同Servlet和HTTP协议时的文件下载。

出现的问题

1 上传文件时，

严重: Exception occurred during processing request: /Users/apple/Documents/workspace/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/Union/WEB-INF/uploadFiles/acm.txt (No such file or directory)
java.io.FileNotFoundException: /Users/apple/Documents/workspace/.metadata/.plugins/org.eclipse.wst.server.core/tmp0/wtpwebapps/Union/WEB-INF/uploadFiles/acm.txt (No such file or directory)

原因：设置放在uploadFiles文件夹下，但uploadFiles文件夹不存在，所以抛出文件不存在异常。

解决方案：在上传文件的action创建文件输出流之前，先检测该文件夹是否存在，若不存在则创建。

2 下载文件时，

严重: Exception occurred during processing request: Can not find a java.io.InputStream with the name [targetFile] in the invocation stack. Check the <param name="inputName"> tag specified for this action.
java.lang.IllegalArgumentException: Can not find a java.io.InputStream with the name [targetFile] in the invocation stack. Check the <param name="inputName"> tag specified for this action.

原因：

（1）struts.xml中返回中的inputName的值与action中的方法名不对应。

（2）文件为不允许类型或超出文件设定大小。

（3）action中创建文件输入流时传入的路径错误。

（4）文件名中含有中文字符，则导致无法创建文件输入流。

解决方案：

针对（1）~（3），仔细检查。

针对（4），在setFilename()方法返回时对文件名进行处理，

public void setFilename(String filename) throws UnsupportedEncodingException {
    this.filename = new String(filename.getBytes("ISO8859-1"), "utf-8");
}

而做了如上处理后，虽然没有异常被抛出，但发现在下载含中文字符的文件时，下载的文件的文件名仍然时乱码。

所以就在Action中另添加一个方法。

public String getDownloadFilename() throws UnsupportedEncodingException {
    return new String(filename.getBytes(), "ISO9959-1");
}

并将struts.xml中result中的contentDisposition的值改为对象的值。

<param name="contentDisposition">attachment;filename="${downloadFilename}"</param>

以上即为全部内容，欢迎提出问题和建议！