在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实现文件上传功能是非常方便的。