文件的上传和下载

文件的上传和下载，是非常常见的功能。很多的系统中，或者软件中都经常使用文件的上传和下载。比如：QQ 头像，就使用了上传。邮箱中也有附件的上传和下载功能。 OA 系统中审批有附件材料的上传。

文件的上传

要有一个 form 标签，method=post 请求
form 标签的 enctype 属性值必须为 multipart/form-data 值
在 form 标签中使用 input type=file 添加上传的文件
编写服务器代码（这里使用Servlet 程序）接收，处理上传的数据。

enctype =multipart/form-data 表示提交的数据，以多段（每一个表单项一个数据段）的形式进行拼接，然后以二进制流的形式发送给服务器。

upload.jsp：

<body>
    <form action="http://localhost:8080/demo/uploadServlet" method="post" enctype="multipart/form-data">
        用户名：<input type="text" name="username" /> <br>
        头像：<input type="file" name="photo" /> <br>
        <input type="submit" value="上传" />
    </form>
</body>

之后再写一个 UploadServlet.java(重写doPost方法) , 配置访问地址为 uploadServlet。

文件上传时HTTP 协议的说明

Content-Type 表示提交的数据类型

multipart/form-data 表示提交的数据，以多段(每一个表单项一个数据段)的形式进行拼接，然后以二进制流的形式发送给服务器。

boundary 表示每段数据的分隔符

----WebKitFormBoundaryfR6ijBPPqbdkIBkO是由浏览器每次都随机生成。它就是每段数据的分隔符。

下面以服务器不以流的形式接收为例：

@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
	//以流的形式发给服务器，则只能以流的形式接收
	//以不是流的形式接收为例
	System.out.println(req.getParameter("username"));
	System.out.println(req.getParameter("photo"));
}

在浏览器上传过文件之后，在idea的控制台输出了两个 null 。

下面以流的形式接收数据为例：

@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
    ServletInputStream inputStream = req.getInputStream();
    //需要创建一个buff缓冲区
    byte[] buffer = new byte[1024000];
    int read = inputStream.read(buffer);
    System.out.println(new String(buffer,0,read));  //从0开始读了 read 个
}

commons-fileupload.jar 常用 API 介绍说明

commons-fileupload.jar 需要依赖 commons-io.jar 这个包，所以两个包我们都要引入。

需要导入两个 jar 包：

commons-fileupload-1.2.1.jar
commons-io-1.4.jar

commons-fileupload.jar 和 commons-io.jar 包中，我们常用的类有哪些？

ServletFileUpload 类，用于解析上传的数据。
FileItem 类，表示每一个表单项。

常用的方法：

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);
判断当前上传的数据格式是否是多段的格式。
publicList< FileItem >parseRequest(HttpServletRequestrequest)
解析上传的数据
boolean FileItem.isFormField()
判断当前这个表单项，是否是普通的表单项。还是上传的文件类型
true 表示普通类型的表单项
false 表示上传的文件类型
String FileItem.getFieldName() 获取表单项的 name 属性值
String FileItem.getString() 获取当前表单项的值
String FileItem.getName() 获取上传的文件名
void FileItem.write(file) 将上传的文件写到参数 file 所指向抽硬盘位置

fileupload 类库的使用

public class UploadServlet extends HttpServlet {
    /**
     * 用来处理文件上传的数据
     *
     * @param req
     * @param resp
     * @throws ServletException
     * @throws IOException
     */
    @Override
    protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //1.先判断上传的数据是否是多段的数据
        //ServletFileUpload.isMultipartContent(req)返回true就说明是多段的，返回false就说明不是
        if (ServletFileUpload.isMultipartContent(req)) {

            //创建 FileItemFactory 工厂实现类
            FileItemFactory fileItemFactory = new DiskFileItemFactory();
            //创建用于解析上传数据的工具类 ServletFileUpload
            ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
            //解析上传的数据，得到一个表单项 FileItem
            try {
                List<FileItem> list = servletFileUpload.parseRequest(req);

                //循环判断每一个表单项是普通类型还是上传的文件
                for (FileItem fileItem : list) {

                    if (fileItem.isFormField()) {
                        //普通表单项
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        //参数 UTF-8 解决中文乱码问题
                        System.out.println("表单项的value属性值：" + fileItem.getString("UTF-8"));
                    } else {
                        //上传的文件
                        System.out.println("表单项的name属性值：" + fileItem.getFieldName());
                        System.out.println("上传的文件名：" + fileItem.getName());
                        fileItem.write(new File("d:\\study\\" + fileItem.getName()));
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

// : 这是单行注释
\ : 比如说C:\ls\123\JDBC2\bin, 表示的是电脑磁盘上的默认路径分隔符，但在Java编译器中，它会默认改成"\"这种形式，尤其是io流那块需要相对路径和绝对路径的时候，以及后续的配置文件的加载(load)等都会用到。
/ : 它在路径中就相当于"\"，这是Java路径的两种写法

文件的下载

下载的常用 API 说明：

response.getOutputStream();
servletContext.getResourceAsStream();
servletContext.getMimeType();
response.setContentType();
response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”);

响应头的设置是告诉浏览器。这是需要下载的。而 attachment 表示附件，也就是下载的一个文件。fileName=后面，表示下载的文件名。

完成上面的两个步骤，下载文件是没问题了。但是如果我们要下载的文件是中文名的话。你会发现，下载无法正确显示出正确的中文名。

原因是在响应头中，不能包含有中文字符，只能包含 ASCII 码。

public class DownLoad extends HttpServlet {
    
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //1.获取需要下载的文件名
        String downloadFileName = "a.jpg";

        //2.读取要下载的文件内容(通过 ServletContext 对象可以获取)
        ServletContext servletContext = getServletContext();
        //获取要下载的文件类型
        String mimeType = servletContext.getMimeType("/file/" + downloadFileName);
        System.out.println("下载的文件类型：" + mimeType);

        //4.在回传之前，通过响应头告诉客户端返回的数据类型
        resp.setContentType(mimeType);
        //5.还要告诉客户端收到的数据适用于下载使用（还是使用响应头）
        // Content-Disposition 响应头，表示收到的数据怎么处理
        // attachment 表示附件，下载使用；
        // filename= 表示指定下载的文件名
        resp.setHeader("Content-Disposition", "attachment;filename=" + downloadFileName);

        /*
        在服务器端，第一个 / 被解析为： http://ip:port/工程名/  映射到代码的 web 目录
         */
        InputStream resourceAsStream = servletContext.getResourceAsStream("/file/" + downloadFileName);
        // 原先是用 byte[] 来读，这里改变一下，通过使用 commons-io-1.4.jar 包里已经写好的工具类 IOUtils
        // 获取响应的输出流
        OutputStream outputStream = resp.getOutputStream();

        //3.把下载的文件内容传回客户端
        // 读取输出流中全部的数据，复制给输出流，输出给客户端
        IOUtils.copy(resourceAsStream, outputStream);
    }
}

另外：

resp.setHeader("Content-Disposition","attachment;filename=中国.jpg");

下载的文件的名字会出现乱码，需要对这一段进行 Encoder 编码：

resp.setHeader("Content-Disposition","attachment;filename=" + URLEncoder.encode("中国.jpg","UTF-8"));

附件中文名乱码问题解决方案

方案一：URLEncoder 解决IE和谷歌浏览器的附件中文名问题

如果客户端浏览器是 IE 浏览器或者是谷歌浏览器。我们需要使用 URLEncoder 类先对中文名进行 UTF-8 的编码操作。

因为 IE 浏览器和谷歌浏览器收到含有编码后的字符串后会以 UTF-8 字符集进行解码显示。

// 把中文名进行 UTF-8 编码操作。 
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8"); 
// 然后把编码后的字符串设置到响应头中 
response.setHeader("Content-Disposition", str);

方案二： BASE64 编解码解决火狐浏览器的附件中文名问题

如果客户端浏览器是火狐浏览器。那么我们需要对中文名进行 BASE64 的编码操作。

这时候需要把请求头 Content-Disposition: attachment; filename=中文名编码成为：Content-Disposition: attachment; filename==?charset?B?xxxxx?=

因为火狐使用的是 BASE64 的编解码方式还原响应中的汉字。所以需要使用 BASE64Encoder 类进行编码操作。

// 使用下面的格式进行 BASE64 编码后
String str = "attachment; fileName=" + "=?utf-8?B?" 
    + new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 设置到响应头中
response.setHeader("Content-Disposition", str);

那么我们如何解决上面两种不同编解码方式呢。我们只需要通过判断请求头中 User-Agent 这个请求头携带过来的浏览器信息即可判断出是什么浏览器。

如下：

String ua = request.getHeader("User-Agent");
// 判断是否是火狐浏览器
if (ua.contains("Firefox")) {
// 使用下面的格式进行 BASE64 编码后
String str = "attachment; fileName=" + "=?utf-8?B?"
    + new BASE64Encoder().encode("中文.jpg".getBytes("utf-8")) + "?=";
// 设置到响应头中
response.setHeader("Content-Disposition", str);
} else {
// 把中文名进行 UTF-8 编码操作。
String str = "attachment; fileName=" + URLEncoder.encode("中文.jpg", "UTF-8");
// 然后把编码后的字符串设置到响应头中
response.setHeader("Content-Disposition", str);