JavaWeb文件下载文件名称变成下划线的完美解决与分析

问题： 下载的文件名称变为下划线

文件下载的步骤有三大步骤：

1. 设置响应对象的媒体类型
2. 设置下载窗口
3. IO流对文件的读写

问题分析： 首先，问题所在是我们下载的文件名称中文变成了下划线，所以我们可以断定和第一步设置响应对象的媒体类型无关。再去看文件的大小是可以读取出来的，所以我们这也可以说明此问题和IO读写文件也无关。两个步骤排除了就剩下设置下载窗口了。答案：问题就是出在设置下载窗口上！

设置下载窗口： 设置下载窗口是通过响应对象对响应头的操作（“Content-Disposition”）

浏览器问题： 各种浏览器的编码解码都是不同的，所以不同的浏览器对文件名称的编码方式不同，我们要以Google浏览器为代表的是以utf-8对文件名称进行编码，其他的一些浏览器以base64对文件名称进行编码，这就需要判断响应头中使用的浏览器的类型（User-Agent）

处理编码的方法代码：

    /**
     * base64编码
     *
     * @param fileName 文件名称
     * @return 返回一个处理编码后的文件名称
     */
    public String base64EncodeFileName(String fileName) {
        BASE64Encoder base64Encoder = new BASE64Encoder();

        try {
            return "=?UTF‐8?B?" + new String(base64Encoder.encode(fileName.getBytes("utf-8"))) + "?=";
        } catch (Exception e) {
            e.printStackTrace();

            throw new RuntimeException(e);
        }
    }

贴代码：

package com.mylifes1110.java.controller;

import java.io.*;

import java.net.URLEncoder;

import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import sun.misc.BASE64Encoder;

@WebServlet(
    name  = "DownloadServlet",
    value = "/download"
)
public class DownloadServlet extends HttpServlet {

    /**
     * base64编码
     *
     * @param fileName 文件名称
     * @return 返回一个处理编码后的文件名称
     */
    public String base64EncodeFileName(String fileName) {
        BASE64Encoder base64Encoder = new BASE64Encoder();

        try {
            return "=?UTF‐8?B?" + new String(base64Encoder.encode(fileName.getBytes("utf-8"))) + "?=";
        } catch (Exception e) {
            e.printStackTrace();

            throw new RuntimeException(e);
        }
    }

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doPost(request, response);
    }

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        String fileName = request.getParameter("filename");

        // 获取下载文件的媒体类型
        String mimeType = request.getServletContext().getMimeType(fileName);

        // 1.设置媒体类型
        response.setContentType(mimeType);

        // 2.设置下载窗口  "Content-Disposition"

        /**
         * 不同的浏览器对文件名称的编码方式不同，以google浏览器为代表的是以utf-8对文件名称进行编码
         * 其他的一些浏览器以base64对文件名称进行编码
         * 判断使用的浏览器的类型User-Agent
         */
        String userAgent   = request.getHeader("User-Agent");
        String newFileName = null;

        if (userAgent.contains("Chrome")) {

            // Google浏览器以utf-8进行编码
            newFileName = URLEncoder.encode(fileName, "utf-8");
        } else {

            // 其他浏览器以base64进行编码
            newFileName = base64EncodeFileName(fileName);
        }

        // Google浏览器：new String(fileName.getBytes("utf-8"), "ISO8859-1")
        // 注释中的Google浏览器的代码只针对Google浏览器，不具有普适性！
        // response.setHeader("Content-Disposition", "attachement;filename=" + new String(fileName.getBytes("utf-8"), "ISO8859-1"));
        response.setHeader("Content-Disposition", "attachement;filename=" + newFileName);

        // 3.IO读写
        String path = request.getServletContext().getRealPath("upload") + File.separator + fileName;

        System.out.println(path);

        BufferedInputStream  bufferedInputStream  = new BufferedInputStream(new FileInputStream(path));
        BufferedOutputStream bufferedOutputStream = new BufferedOutputStream(response.getOutputStream());
        byte[]               bytes                = new byte[8192];
        int                  len                  = -1;

        while ((len = bufferedInputStream.read(bytes)) != -1) {
            bufferedOutputStream.write(bytes, 0, len);
        }

        bufferedInputStream.close();
        bufferedOutputStream.close();
    }
}