【JavaWeb学习】文件的上传和下载

一、文件上传

1.1、概述

实现web开发中的文件上传功能，需完成如下二步操作：

在web页面中添加上传输入项
在servlet中读取上传文件的数据，并保存到本地硬盘中

如何在web页面中添加上传输入项?

<input type="file"> 标签用于在web页面中添加文件上传输入项，设置文件上传输入项时须注意：
1、必须要设置 input 输入项的 name 属性，否则浏览器将不会发送上传文件的数据。
２、必须把form的 enctype 属值设为 multipart/form-data ，这样浏览器在上传文件时，才会把文件数据附带在http请求消息体中，并使用MIME协议对上传的文件进行描述，以方便接收方对上传数据进行解析和处理。

如果表单的提交类型为multipart/form-data,那么表单的数据将不能通过传统方式获得。如何获得？如何在Servlet中读取文件上传数据，并保存到本地硬盘中？

Request对象提供了一个getInputStream方法，通过这个方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件，在servlet端编程直接读取上传数据，并分别解析出相应的文件数据是一项非常麻烦的工作。

为方便用户处理文件上传数据，Apache 开源组织提供了一个用来处理表单文件上传的一个开源组件 Commons-fileupload ，该组件性能优异，并且其API使用极其简单，可以让开发人员轻松实现web文件上传功能，因此在web开发中实现文件上传功能，通常使用Commons-fileupload组件实现。

使用Commons-fileupload组件实现文件上传，需要导入该组件相应的支撑jar包：Commons-fileupload和commons-io。commons-io 不属于文件上传组件的开发jar文件，但Commons-fileupload 组件从1.1 版本开始，它工作时需要commons-io包的支持。

1.2、fileupload组件工作流程

核心API—DiskFileItemFactory

　　常用方法有：

public void setSizeThreshold(int sizeThreshold) 设置内存缓冲区的大小，默认值为10K。当上传文件大于缓冲区大小时， fileupload组件将使用临时文件缓存上传文件。

public void setRepository(java.io.File repository) 指定临时文件目录，默认值为System.getProperty("java.io.tmpdir").

public DiskFileItemFactory(int sizeThreshold, java.io.File repository) 构造函数

核心API—ServletFileUpload

ServletFileUpload 负责处理上传的文件数据，并将表单中每个输入项封装成一个 FileItem 对象中。常用方法有：

boolean isMultipartContent(HttpServletRequest request) 判断上传表单是否为multipart/form-data类型
List parseRequest(HttpServletRequest request) 解析request对象，并把表单中的每一个输入项包装成一个fileItem 对象，并返回一个保存了所有FileItem的list集合。
setFileSizeMax(long fileSizeMax) 设置上传文件的最大值
setSizeMax(long sizeMax) 设置上传文件总量的最大值
setHeaderEncoding(java.lang.String encoding) 设置编码格式
setProgressListener(ProgressListener pListener)

1.3、文件上传案例

　　实现步骤

创建DiskFileItemFactory对象，设置缓冲区大小和临时文件目录
使用DiskFileItemFactory 对象创建ServletFileUpload对象，并设置上传文件的大小限制。
调用ServletFileUpload.parseRequest方法解析request对象，得到一个保存了所有上传内容的List对象。
对list进行迭代，每迭代一个FileItem对象，调用其isFormField方法判断是否是上传文件，若为普通表单字段，则调用getFieldName、getString方法得到字段名和字段值，若为上传文件，则调用getInputStream方法得到数据输入流，从而读取上传数据。

上传页面upload.jsp

 1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
 2 
 3 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
 4 <html>
 5 <head>
 6     <title>上传文件案例</title>
 7 </head>
 8 
 9 <body>
10     <form action="${pageContext.request.contextPath }/servlet/UploadServlet" 
11                                         enctype="multipart/form-data" method="post">
12         上传用户：&nbsp;&nbsp;<input type="text" name="username"><br>
13         上传文件1：<input type="file" name="uploadfile1"><br>
14         上传文件2：<input type="file" name="uploadfile2"><br>
15         
16         <input type="reset" value="重置"><br>
17         <input type="submit" value="上传">
18     </form>
19 </body>
20 </html>

后台UploadServlet.java

 1 public class UploadServlet extends HttpServlet {
 2 
 3     public void doPost(HttpServletRequest request, HttpServletResponse response)
 4             throws ServletException, IOException {
 5         request.setCharacterEncoding("UTF-8");
 6         response.setCharacterEncoding("UTF-8");
 7         PrintWriter writer = response.getWriter();
 8         //上传目录
 9         String webroot = this.getServletContext().getRealPath("/");
10         File uploadDir = new File(webroot + "upload");
11         if(!uploadDir.exists()){
12             uploadDir.mkdirs();
13         }
14         try{
15             DiskFileItemFactory factory  = new DiskFileItemFactory();
16             
17             //调用解析器解析request
18             ServletFileUpload servletFileUpload = new ServletFileUpload(factory);
19             if(!servletFileUpload.isMultipartContent(request)){
20                 //按照传统方式获取request表单数据
21                 request.getParameter("username");
22                 return;
23             }
24             List<FileItem> list = servletFileUpload.parseRequest(request);
25             for(FileItem item : list){
26                 //判断字段类型
27                 if(item.isFormField()){
28                     //表单字段
29                     String fieldname = item.getFieldName();
30                     String value = item.getString();
31                     writer.println(fieldname + ":" + value);
32                 }else{
33                     //上传文件
34                     String filename = item.getName().substring(item.getName().lastIndexOf("\")+1);
35                     File uploadFile = new File(uploadDir, filename);
36                     writer.println("上传文件:"+uploadFile.getAbsolutePath());
37                     //读写
38                     InputStream in = item.getInputStream();
39                     OutputStream out = new FileOutputStream(uploadFile);                    
40                     byte[] buf = new byte[1024];
41                     int len = 0;
42                     while((len=in.read(buf))>0){
43                         out.write(buf,0,len);
44                     }
45                     out.close();
46                     in.close();
47                 }
48             }
49             writer.println("上传完毕");
50         }catch (Exception e) {
51             throw new RuntimeException(e);
52         }
53     }
54 
55     public void doGet(HttpServletRequest request, HttpServletResponse response)
56             throws ServletException, IOException {
57         doPost(request, response);
58     }
59 
60 }

提交后显示浏览器显示

二、文件下载

　　程序实现下载需设置两个响应头：设置Content-Type 的值为：application/x-msdownload。Web 服务器需要告诉浏览器其所输出的内容的类型不是普通的文本文件或 HTML 文件，而是一个要保存到本地的下载文件；Web 服务器希望浏览器不直接处理相应的实体内容，而是由用户选择将相应的实体内容保存到一个文件中，这需要设置 Content-Disposition 报头。该报头指定了接收程序处理数据内容的方式，在 HTTP 应用中只有 attachment 是标准方式，attachment 表示要求用户干预。在 attachment 后面还可以指定 filename 参数，该参数是服务器建议浏览器将实体内容保存到文件中的文件名称。在设置 Content-Dispostion 之前一定要指定 Content-Type

 1 public class DownloadServlet extends HttpServlet {
 2     private static final long serialVersionUID = 1L;
 3    
 4     protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
 5         request.setCharacterEncoding("UTF-8");
 6         response.setCharacterEncoding("UTF-8");
 7         
 8         String filename = "1.jpg";
 9         //下载头
10         response.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(filename, "UTF-8"));
11         
12         String imgPath = this.getServletContext().getRealPath("/upload/1.jpg");
13         
14         InputStream in = new FileInputStream(new File(imgPath));
15         OutputStream out = response.getOutputStream();
16         byte[] bytes = new byte[1024];
17         while(in.read(bytes) > 0){
18             out.write(bytes);
19         }
20         in.close();
21     }
22 }

jsp页面

 1 <%@ page language="java" contentType="text/html; charset=UTF-8"
 2     pageEncoding="UTF-8"%>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 4 <html>
 5 <head>
 6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 7 <title>文件下载案例</title>
 8 </head>
 9 <body>
10     <a href="servlet/downloadServlet">文件下载</a>
11 </body>
12 </html>