Servlet3.0学习总结(三)——基于Servlet3.0的文件上传

在Servlet2.5中，我们要实现文件上传功能时，一般都需要借助第三方开源组件，例如Apache的commons-fileupload组件，在Servlet3.0中提供了对文件上传的原生支持，我们不需要借助任何第三方上传组件，直接使用Servlet3.0提供的API就能够实现文件上传功能了。

@MultipartConfig

该注解主要是为了辅助 Servlet 3.0 中 HttpServletRequest 提供的对上传文件的支持。该注解标注在 Servlet 上面，以表示该 Servlet 希望处理的请求的 MIME 类型是 multipart/form-data。另外，它还提供了若干属性用于简化对上传文件的处理。具体如下：

表 5. @MultipartConfig 的常用属性

属性名	类型	是否可选	描述
fileSizeThreshold	int	是	当数据量大于该值时，内容将被写入文件。
location	String	是	存放生成的文件地址。
maxFileSize	long	是	允许上传的文件最大值。默认值为 -1，表示没有限制。
maxRequestSize	long	是	针对该 multipart/form-data 请求的最大数量，默认值为 -1，表示没有限制。

一、使用Servlet3.0提供的API实现文件上传

1.1、编写上传页面

 1 <%@ page language="java" pageEncoding="UTF-8"%>
 2 <!DOCTYPE HTML>
 3 <html>
 4   <head>
 5     <title>Servlet3.0实现文件上传</title>
 6   </head>
 7
 8   <body>
 9         <fieldset>
10             <legend>
11                 上传单个文件
12             </legend>
13             <!-- 文件上传时必须要设置表单的enctype="multipart/form-data"-->
14             <form action="${pageContext.request.contextPath}/UploadServlet"
15                 method="post" enctype="multipart/form-data">
16                 上传文件：
17                 <input type="file" name="file">
18                 <br>
19                 <input type="submit" value="上传">
20             </form>
21         </fieldset>
22         <hr />
23         <fieldset>
24             <legend>
25                 上传多个文件
26             </legend>
27             <!-- 文件上传时必须要设置表单的enctype="multipart/form-data"-->
28             <form action="${pageContext.request.contextPath}/UploadServlet"
29                 method="post" enctype="multipart/form-data">
30                 上传文件：
31                 <input type="file" name="file1">
32                 <br>
33                 上传文件：
34                 <input type="file" name="file2">
35                 <br>
36                 <input type="submit" value="上传">
37             </form>
38         </fieldset>
39     </body>
40 </html>

1.2、开发处理文件上传的Servlet

　　1、使用注解@MultipartConfig将一个Servlet标识为支持文件上传。

　　2、Servlet3.0将multipart/form-data的POST请求封装成Part，通过Part对上传的文件进行操作。

　　UploadServlet 代码如下：

 1 package me.gacl.web.controller;
 2
 3 import java.io.File;
 4 import java.io.IOException;
 5 import java.io.PrintWriter;
 6 import java.util.Collection;
 7
 8 import javax.servlet.ServletException;
 9 import javax.servlet.annotation.MultipartConfig;
10 import javax.servlet.annotation.WebServlet;
11 import javax.servlet.http.HttpServlet;
12 import javax.servlet.http.HttpServletRequest;
13 import javax.servlet.http.HttpServletResponse;
14 import javax.servlet.http.Part;
15
16 //使用@WebServlet配置UploadServlet的访问路径
17 @WebServlet(name="UploadServlet",urlPatterns="/UploadServlet")
18 //使用注解@MultipartConfig将一个Servlet标识为支持文件上传
19 @MultipartConfig//标识Servlet支持文件上传
20 public class UploadServlet extends HttpServlet {
21
22     public void doGet(HttpServletRequest request, HttpServletResponse response)
23             throws ServletException, IOException {
24              request.setCharacterEncoding("utf-8");
25             response.setCharacterEncoding("utf-8");
26             response.setContentType("text/html;charset=utf-8");
27             //存储路径
28             String savePath = request.getServletContext().getRealPath("/WEB-INF/uploadFile");
29             //获取上传的文件集合
30             Collection<Part> parts = request.getParts();
31             //上传单个文件
32             if (parts.size()==1) {
33                  //Servlet3.0将multipart/form-data的POST请求封装成Part，通过Part对上传的文件进行操作。
34                 //Part part = parts[0];//从上传的文件集合中获取Part对象
35                 Part part = request.getPart("file");//通过表单file控件(<input type="file" name="file">)的名字直接获取Part对象
36                 //Servlet3没有提供直接获取文件名的方法,需要从请求头中解析出来
37                 //获取请求头，请求头的格式：form-data; name="file"; filename="snmp4j--api.zip"
38                 String header = part.getHeader("content-disposition");
39                 //获取文件名
40                 String fileName = getFileName(header);
41                 //把文件写到指定路径
42                 part.write(savePath+File.separator+fileName);
43             }else {
44                 //一次性上传多个文件
45                 for (Part part : parts) {//循环处理上传的文件
46                     //获取请求头，请求头的格式：form-data; name="file"; filename="snmp4j--api.zip"
47                     String header = part.getHeader("content-disposition");
48                     //获取文件名
49                     String fileName = getFileName(header);
50                     //把文件写到指定路径
51                     part.write(savePath+File.separator+fileName);
52                 }
53             }
54             PrintWriter out = response.getWriter();
55             out.println("上传成功");
56             out.flush();
57             out.close();
58     }
59
60      /**
61      * 根据请求头解析出文件名
62      * 请求头的格式：火狐和google浏览器下：form-data; name="file"; filename="snmp4j--api.zip"
63      *                 IE浏览器下：form-data; name="file"; filename="E:\snmp4j--api.zip"
64      * @param header 请求头
65      * @return 文件名
66      */
67     public String getFileName(String header) {
68         /**
69          * String[] tempArr1 = header.split(";");代码执行完之后，在不同的浏览器下，tempArr1数组里面的内容稍有区别
70          * 火狐或者google浏览器下：tempArr1={form-data,name="file",filename="snmp4j--api.zip"}
71          * IE浏览器下：tempArr1={form-data,name="file",filename="E:\snmp4j--api.zip"}
72          */
73         String[] tempArr1 = header.split(";");
74         /**
75          *火狐或者google浏览器下：tempArr2={filename,"snmp4j--api.zip"}
76          *IE浏览器下：tempArr2={filename,"E:\snmp4j--api.zip"}
77          */
78         String[] tempArr2 = tempArr1[2].split("=");
79         //获取文件名，兼容各种浏览器的写法
80         String fileName = tempArr2[1].substring(tempArr2[1].lastIndexOf("\\")+1).replaceAll("\"", "");
81         return fileName;
82     }
83
84     public void doPost(HttpServletRequest request, HttpServletResponse response)
85             throws ServletException, IOException {
86         this.doGet(request, response);
87     }
88 }

运行结果如下：

　　可以看到，使用Servlet3.0提供的API实现文件上传功能是非常方便的。