文件的上传与下载

文件的上传和下载，是非常常见的功能。很多的系统中，或者软件中都经常使用文件的上传和下载。

比如：QQ 头像，就使用了上传。

邮箱中也有附件的上传和下载功能。

OA 系统中审批有附件材料的上传。

1. 文件的上传(重点)

具体步骤：

  1. 要有一个 form 标签，method=post 请求

  2. form 标签的 encType 属性值必须为 multipart/form-data 值

  3. 在 form 标签中使用 input type=file 添加上传的文件

  4. 编写服务器代码（Servlet 程序）接收，处理上传的数据。

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

1.1. 文件上传，HTTP 协议的说明。

day09_文件上传与下载 - 图1

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

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

第一步，就是需要导入两个 jar 包：

  1. `commons-fileupload-1.2.1.jar`
  3. `commons-io-1.4.jar`

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

ServletFileUpload 类，用于解析上传的数据。

FileItem 类，表示每一个表单项。

boolean ServletFileUpload.isMultipartContent(HttpServletRequest request);

  1.     判断当前上传的数据格式是否是多段的格式。

public List parseRequest(HttpServletRequest request)

  1.     解析上传的数据

boolean FileItem.isFormField()

  1.     判断当前这个表单项，是否是普通的表单项。还是上传的文件类型。
  3.     true 表示普通类型的表单项
  5.     false 表示上传的文件类型

String FileItem.getFieldName()

  1.     获取表单项的 name 属性值

String FileItem.getString()

  1.     获取当前表单项的值。

String FileItem.getName();

  1.     获取上传的文件名

void FileItem.write( file );

  1.     将上传的文件写到 参数 file 所指向的硬盘位置 。

1.3. fileupload 类库的使用

上传文件的表单：

  1. <form action="http://192.168.31.74:8080/09_EL_JSTL/uploadServlet" method="post"
  2. enctype="multipart/form-data">
  3.     用户名：<input type="text" name="username" /> <br>
  4.     头像：<input type="file" name="photo" > <br>
  5.     <input type="submit" value="上传">
  6. </form>

解析上传的数据的代码：

  1. public class UploadServlet extends HttpServlet {
  2.     /**
  3.      * 用来处理上传的数据
  4.      * @param req
  5.      * @param resp
  6.      * @throws ServletException
  7.      * @throws IOException
  8.      */
  9.     @Override
  10.     protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
  12.         //1 先判断上传的数据是否多段数据（只有是多段的数据，才是文件上传的）
  13.         if (ServletFileUpload.isMultipartContent(req)) {
  14. //           创建FileItemFactory工厂实现类
  15.             FileItemFactory fileItemFactory = new DiskFileItemFactory();
  16.             // 创建用于解析上传数据的工具类ServletFileUpload类
  17.             ServletFileUpload servletFileUpload = new ServletFileUpload(fileItemFactory);
  18.             try {
  19.                 // 解析上传的数据，得到每一个表单项FileItem
  20.                 List<FileItem> list = servletFileUpload.parseRequest(req);
  21.                 // 循环判断，每一个表单项，是普通类型，还是上传的文件
  22.                 for (FileItem fileItem : list) {
  24.                     if (fileItem.isFormField()) {
  25.                         // 普通表单项
  27.                         System.out.println("表单项的name属性值：" + fileItem.getFieldName());
  28.                         // 参数UTF-8.解决乱码问题
  29.                         System.out.println("表单项的value属性值：" + fileItem.getString("UTF-8"));
  31.                     } else {
  32.                         // 上传的文件
  33.                         System.out.println("表单项的name属性值：" + fileItem.getFieldName());
  34.                         System.out.println("上传的文件名：" + fileItem.getName());
  36.                         fileItem.write(new File("e:\\" + fileItem.getName()));
  37.                     }
  38.                 }
  39.             } catch (Exception e) {
  40.                 e.printStackTrace();
  41.             }
  42.         }
  43.     }
  44. }

2. 文件的下载

day09_文件上传与下载 - 图2

下载的常用 API 说明：

response.getOutputStream();：获取响应输出流

servletContext.getResourceAsStream()：获取需要下载的文件输入流

servletContext.getMimeType() ：获取数据类型的字符串描述符

response.setContentType()：通过响应头告诉客户端返回的数据类型

response.setHeader(“Content-Disposition”, “attachment; fileName=1.jpg”); 这个响应头告诉浏览器。这是需要下载的。而attachment 表示附件，也就是下载的一个文件。fileName=后面， 表示下载的文件名。

完成上面的两个步骤，下载文件是没问题了。但是如果我们要下载的文件是中文名的话。你会发现下载无法正确显示出正确的中文名。 原因是在响应头中，不能包含有中文字符，只能包含 ASCII 码。

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

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

如果客户端浏览器是 IE 浏览器 或者 是谷歌浏览器。我们需要使用 URLEncoder 类先对中文名进行 UTF-8 的编码 操作。 因为 IE 浏览器和谷歌浏览器收到含有编码后的字符串后会以 UTF-8 字符集进行解码显示。

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

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

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

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

=?charset?B?xxxxx?= 现在我们对这段内容进行一下说明。

=?：表示编码内容的开始

charset：表示字符集

B ：表示使用BASE64编码

xxxx ：表示文件名BASE64编码后的内容

?=：表示编码内容的结束

BASE64 编解码操作

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

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

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

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

2.2. 文件下载最终版

  1. public class Download extends HttpServlet {
  4.     @Override
  5.     protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
  6. //        1、获取要下载的文件名
  7.         String downloadFileName = "2.jpg";
  8. //        2、读取要下载的文件内容 (通过ServletContext对象可以读取)
  9.         ServletContext servletContext = getServletContext();
  10.         // 获取要下载的文件类型
  11.         String mimeType = servletContext.getMimeType("/file/" + downloadFileName);
  12.         System.out.println("下载的文件类型：" + mimeType);
  13. //        4、在回传前，通过响应头告诉客户端返回的数据类型
  14.         resp.setContentType(mimeType);
  15. //        5、还要告诉客户端收到的数据是用于下载使用（还是使用响应头）
  16.         // Content-Disposition响应头，表示收到的数据怎么处理
  17.         // attachment表示附件，表示下载使用
  18.         // filename= 表示指定下载的文件名
  19.         // url编码是把汉字转换成为%xx%xx的格式
  20.         if (req.getHeader("User-Agent").contains("Firefox")) {
  21.             // 如果是火狐浏览器使用Base64编码
  22.             resp.setHeader("Content-Disposition", "attachment; filename==?UTF-8?B?" + new BASE64Encoder().encode("中国.jpg".getBytes("UTF-8")) + "?=");
  23.         } else {
  24.             // 如果不是火狐，是IE或谷歌，使用URL编码操作
  25.             resp.setHeader("Content-Disposition", "attachment; filename=" + URLEncoder.encode("中国.jpg", "UTF-8"));
  26.         }
  27.         /**
  28.          * /斜杠被服务器解析表示地址为http://ip:prot/工程名/  映射 到代码的Web目录
  29.          */
  30.         InputStream resourceAsStream = servletContext.getResourceAsStream("/file/" + downloadFileName);
  31.         // 获取响应的输出流
  32.         OutputStream outputStream = resp.getOutputStream();
  33.         //        3、把下载的文件内容回传给客户端
  34.         // 读取输入流中全部的数据，复制给输出流，输出给客户端
  35.         IOUtils.copy(resourceAsStream, outputStream);
  36.     }
  37. }