Servlet-提供下载文件

文件下载概述

通常服务器会将响应以字符串的形式返回浏览器，浏览器会解析字符串并在窗口中显示渲染内容。
文件下载也是如此，它需要将资源发送给浏览器，不过需要作一些额外操作，让浏览器知道这个文件是提供给用户下载的，而不是显示的。

Servlet处理文件下载

设置响应类型

默认的MIME类型是text/html，如果提供资源让浏览器下载，那么自然要告诉浏览器资源的类型是什么：

response.setContentType();

如果不了解有哪些MIME类型，可以打开%TOMCAT_HOME%/conf/web.xml，里面有详细的MIME类型以及它们的简写。如果不知道用什么MIME类型，可以直接使用

response.setContentType("application/octet-stream");

设置Content-Disposition

设置Content-Disposition，给他赋值attachment;filename={filename}。
默认的Content-Disposition的值是inline，对于这个，浏览器会将资源在窗口中解析并呈现。而下载资源需要浏览器提供一个弹出框提供下载，所以就是attachment。
filename通常设置成文件名，但是不同的浏览器弹出框的字符编码不同，很有可能中文的文件名在浏览器的弹出框中是乱码。
这篇博客提供了解决方案。

将资源流写入浏览器输出流

可以使用ServletContext#getResourceAsStream()获取资源流。在写入ServletResponse#getOutputStream中。

示例

假设在WEB-INF/resource目录下有个“图片.PNG”,现在提供用户下载可以这样写：

@WebServlet(name = "DownloadServlet",urlPatterns = "/download")
public class DownloadServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("application/octet-stream");
        String filename = HttpUtils.getUniFilename(request, "图片.PNG");
        response.setHeader("Content-Disposition","attachment;filename=\""+filename+"\"");

        IOUtils.copy(getServletContext().getResourceAsStream("WEB-INF/resource/图片.PNG"),response.getOutputStream());
    }
}

其中HttpUtils是我从那篇博客上copy来的解决文件名乱码的方法：

public class HttpUtils {
    private static String[] IEBrowserSignals = {"MSIE", "Trident", "Edge"};
    //判断是否是IE家族的浏览器
    public static boolean isMSBrowser(HttpServletRequest request) {
        String userAgent = request.getHeader("User-Agent");
        for (String signal : IEBrowserSignals) {
            if (userAgent.contains(signal))
                return true;
            }
            return false;
    }

    public static String getUniFilename(HttpServletRequest request,String fileName) throws UnsupportedEncodingException {
        if(isMSBrowser(request)){
            //IE浏览器的乱码问题解决
            fileName = URLEncoder.encode(fileName, "UTF-8");
        }else {
            //万能乱码问题解决
            fileName = new String(fileName.getBytes("UTF-8"), "ISO-8859-1");
        }
        return fileName;
    }
}

亲测有效！！