文件上传

一、文件上传概述

 

1　文件上传的作用

例如网络硬盘！就是用来上传下载文件的。

在招聘网上填写一个完整的简历还需要上传照片等。

2　文件上传对页面的要求

上传文件的要求比较多，需要记一下：

• 必须使用表单，而不能是超链接；
• 表单的method必须是POST，而不能是GET；
• 表单的enctype必须是multipart/form-data；
• 在表单中添加file表单字段，即<input type=”file“ name=”xxx” />

1 <form action="${pageContext.request.contextPath }/FileUploadServlet" method="post" enctype="multipart/form-data">
2 用户名：<input type="text" name="username"/><br/>
3 文件1：<input type="file" name="file1"/><br/>
4 文件2：<input type="file" name="file2"/><br/>
5 <input type="submit" value="提交"/>
6 </form>

3　文件上传对Servlet的要求

• request.getParameter(String)方法获取指定的表单字段字符内容，但文件上传表单已经不在是字符内容，而是字节内容，所以失效。
• ServletInputStream request.getInputStream():包含整个请求体。

4 多部件表单的体

　　①每隔出多个部件，即一个表单项一个部件。

　　②一个部件中字节包含请求头和空行，以及请求体

　　③普通表单项：

• 1个头：Content-Disposition:包含name=“xxxx”,即表单项名称
• 体就是表单项的值

　　④文件表单项：

• Content-Disposition: 包含name=“xx”，即表单项名称，还有一个filename=“xx”，表示上传文件的名称
• Content-Type：它是上传文件的MINE类型，例如：image/pjpeg，表示上传的图片，图中jpg扩展名的图片。
• 体就是上传文件的内容

Request Headers
view parsed
POST /form1.jsp HTTP/1.1
Host: localhost:8080
Connection: keep-alive
Content-Length: 479756
Cache-Control: max-age=0
Origin: http://localhost:8080
Upgrade-Insecure-Requests: 1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary8Wne2EqQO2Ps7E8m
User-Agent: ****
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
Referer: http://localhost:8080/form1.jsp
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en-US;q=0.8,en;q=0.6,zh-CN;q=0.4
Cookie: Idea-e96526d7=db12919d-58f1-479a-b0f7-3104911c767b; JSESSIONID=9DEFDF98FE8715CB5707772F874D8C82
Request Payload
------WebKitFormBoundary8Wne2EqQO2Ps7E8m
Content-Disposition: form-data; name="username"

zhangsan
------WebKitFormBoundary8Wne2EqQO2Ps7E8m
Content-Disposition: form-data; name="picture"; filename="2.jpg"
Content-Type: image/jpeg


------WebKitFormBoundary8Wne2EqQO2Ps7E8m--

5 commons-fileupload

　　fileupload是由apache的commons组件提供的上传组件。它最主要的工作就是帮我们解析request.getInputStream()。

fileupload组件需要的JAR包有：

• commons-fileupload.jar，核心包；
• commons-io.jar，依赖包。

二、fileupload简单应用

1、fileupload的核心类有：DiskFileItemFactory、ServletFileUpload、FileItem。

　　使用fileupload组件的步骤如下：

①创建工厂类DiskFileItemFactory对象：DiskFileItemFactory factory = new DiskFileItemFactory()

②使用工厂创建解析器对象：ServletFileUpload fileUpload = new ServletFileUpload(factory)

③使用解析器来解析request对象：List<FileItem> list = fileUpload.parseRequest(request)

2、FileItem

　　一个FileItem对象对应一个表单项（表单字段）。

　　一个表单中存在文件字段和普通字段，可以使用FileItem类的isFormField()方法来判断表单字段是否为普通字段，如果不是普通字段，那么就是文件字段了。

• boolean isFormField()：判断当前表单字段是否为普通文本字段，如果返回false，说明是文件字段；
• String getFieldName()：获取字段名称，例如：<input type=”text” name=”username”/>，返回的是username；
• String getName()：获取文件字段的文件名称；
• String getString(String charset)：获取字段的内容，如果是文件字段，那么获取的是文件内容，当然上传的文件必须是文本文件；
• String getContentType()：获取上传的文件的类型，例如：text/plain。
• long getSize()：返回上传文件的字节数；
• InputStream getInputStream()：获取上传文件对应的输入流；
• void write(File)：把上传的文件保存到指定文件中。

3、示例：

 1 package servlet;
 2 
 3 import org.apache.commons.fileupload.FileItem;
 4 import org.apache.commons.fileupload.FileUploadException;
 5 import org.apache.commons.fileupload.disk.DiskFileItemFactory;
 6 import org.apache.commons.fileupload.servlet.ServletFileUpload;
 7 
 8 import javax.servlet.ServletException;
 9 import javax.servlet.annotation.WebServlet;
10 import javax.servlet.http.HttpServlet;
11 import javax.servlet.http.HttpServletRequest;
12 import javax.servlet.http.HttpServletResponse;
13 import java.io.File;
14 import java.io.IOException;
15 import java.util.List;
16 
17 @WebServlet(name = "Upload2Servlet",urlPatterns = "/Upload2Servlet")
18 public class Upload2Servlet extends HttpServlet {
19     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
20         request.setCharacterEncoding("utf-8");
21         response.setContentType("text/html;charset=utf-8");
22         /*
23         * 1、得到工厂
24         * 2、通过工厂创建解析器
25         * 3、解析request，得到FileItem集合
26         * 4、遍历FileItem集合，调用其API完成文件的保存
27         * */
28         DiskFileItemFactory factory = new DiskFileItemFactory();
29         ServletFileUpload sfu = new ServletFileUpload(factory);
30         try {
31             List<FileItem> fileItems = sfu.parseRequest(request);
32             FileItem fileItem1 = fileItems.get(0);
33             FileItem fileItem2 = fileItems.get(1);
34 
35             System.out.println("普通表单项演示："+fileItem1.get()+
36                     "="+fileItem1.toString());
37             System.out.println("文件表单演示：");
38             System.out.println("Content-Type:" + fileItem2.getContentType());
39             System.out.println("size:"+fileItem2.getSize());
40             System.out.println("filename:"+fileItem2.getName());
41             //保存文件
42             File destFile = new File("/Users/Shared/picture.jpg");
43             try {
44                 fileItem2.write(destFile);
45             } catch (Exception e) {
46                 throw new RuntimeException(e);
47             }
48         } catch (FileUploadException e) {
49             throw new RuntimeException(e);
50         }
51     }
52 }

 1 <%@ page contentType="text/html;charset=UTF-8" language="java" %>
 2 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
 3 <html>
 4 <head>
 5     <title>Title</title>
 6 </head>
 7 <body>
 8 <h1>上传2</h1>
 9 <form action="<c:url value='/Upload2Servlet'/>" method="post" enctype="multipart/form-data">
10     用户名：<input type="text" name="username"/><br/>
11     照片： <input type="file" name="picture" /><br/>
12     <input type="submit" value="上传">
13 </form>
14 </body>
15 </html>

三、上传的细节

1. 文件必须保存到WEB-INF下！
  * 目的是不让浏览器直接访问到！
  * 把文件保存到WEB-INF目录下！
2. 文件名称相关问题
　* 有的浏览器上传的文件名是绝对路径，这需要切割！C:filesaibing.jpg
   String filename = fi2.getName();
   int index = filename.lastIndexOf("\");
   if(index != -1) {
       filename = filename.substring(index+1);
   }
  * 文件名乱码或者普通表单项乱码：request.setCharacterEncoding("utf-8");因为fileupload内部会调用request.getCharacterEncoding();
   > request.setCharacterEncoding("utf-8");//优先级低
   > servletFileUpload.setHeaderEncoding("utf-8");//优先级高
  * 文件同名问题:我们需要为每个文件添加名称前缀，这个前缀要保证不能重复。uuid
   > filename = CommonUtils.uuid() + "_" + filename;
3. 目录打散
  * 不能在一个目录下存放之多文件。
    > 首字符打散：使用文件的首字母做为目录名称，例如：abc.txt，那么我们把文件保存到a目录下。如果a目录这时不存在，那么创建之。
    > 时间打散：使用当前日期做为目录。
    > 哈希打散：
      * 通过文件名称得到int值，即调用hashCode()
      * 它int值转换成16进制0~9, A~F
      * 获取16进制的前两位用来生成目录，目录为二层！例如：1B2C3D4E5F，/1/B/保存文件。
4. 上传文件的大小限制
  * 单个文件大小限制
    > sfu.setFileSizeMax(100*1024)：限制单个文件大小为100KB
    > 上面的方法调用，必须在解析开始之前调用！
    > 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.FileSizeLimitExceededException
  * 整个请求所有数据大小限制
    > sfu.setSizeMax(1024 * 1024);//限制整个表单大小为1M
    > 这个方法也是必须在parseRequest()方法之前调用
    > 如果上传的文件超出限制，在parseRequest()方法执行时，会抛出异常！FileUploadBase.SizeLimitExceededException
5. 缓存大小与临时目录
  * 缓存大小：超出多大，才向硬盘保存！默认为10KB
  * 临时目录：向硬盘的什么目录保存
  设置缓存大小与临时目录：new DiskFileItemFactory(20*1024, new File("F:/temp"))
 

四、目录打散、上传的大小限制、缓存大小与临时目录示例： 

 1 package servlet;
 2 
 3 import cn.itcast.commons.CommonUtils;
 4 import org.apache.commons.fileupload.FileItem;
 5 import org.apache.commons.fileupload.FileUploadBase;
 6 import org.apache.commons.fileupload.FileUploadException;
 7 import org.apache.commons.fileupload.disk.DiskFileItemFactory;
 8 import org.apache.commons.fileupload.servlet.ServletFileUpload;
 9 
10 import javax.servlet.ServletException;
11 import javax.servlet.annotation.WebServlet;
12 import javax.servlet.http.HttpServlet;
13 import javax.servlet.http.HttpServletRequest;
14 import javax.servlet.http.HttpServletResponse;
15 import java.io.File;
16 import java.io.IOException;
17 import java.util.List;
18 @WebServlet(name = "Upload3Servlet",urlPatterns = "/Upload3Servlet")
19 public class Upload3Servlet extends HttpServlet {
20     protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
21         request.setCharacterEncoding("utf-8");
22         response.setContentType("text/html;charset=utf-8");
23 
24         //工厂
25         DiskFileItemFactory factory = new DiskFileItemFactory(20*1024,new File("/Users/Shared/temp"));
26         //解析器
27         ServletFileUpload sfu = new ServletFileUpload(factory);
28 
29 //        sfu.setFileSizeMax(100*1024);//限制单个文件大小为100KB
30 //        sfu.setSizeMax(100*1024);//限制整个表单大小为100KB
31         //解析，得到List
32         try {
33             List<FileItem> list = sfu.parseRequest(request);
34             FileItem fi = list.get(1);
35 
36             //1、得到文件保存的路径
37             String root = this.getServletContext().getRealPath("/WEB-INF/files");
38             /*
39             * 2、生成二层目录
40             * 得到文件名称
41             * 得到hashCode
42             * 转发成16进制
43             * 获取前两个字符用来生成目录
44             * */
45             String filename = fi.getName();//获取上传文件名称
46             //处理文件名的绝对路径问题
47             int index = filename.lastIndexOf("//");
48             if (index != 1) {
49                 filename = filename.substring(index+1);
50             }
51             //给文件名称添加UUID前缀，处理文件同名问题
52             String savename = CommonUtils.uuid()+"_"+filename;
53             //1、得到hashCode
54             int hCode = filename.hashCode();
55             String hex = Integer.toHexString(hCode);
56             //2、获取hex的前两个字母，与root连接在一起，生成一个完整的路径
57             File dirFile = new File(root,hex.charAt(0)+"/"+hex.charAt(1));
58             //3、创建目录链
59             dirFile.mkdirs();
60             //4、创建目录文件
61             File destFile = new File(dirFile,savename);
62             //5、保存
63             fi.write(destFile);
64         } catch (FileUploadException e) {
65             if(e instanceof FileUploadBase.FileSizeLimitExceededException) {
66                 request.setAttribute("msg", "您上传的文件超出了100KB！");
67                 request.getRequestDispatcher("/form3.jsp").forward(request, response);
68             }
69         } catch (Exception e) {
70             e.printStackTrace();
71         }
72     }
73 }