在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  3  4    5      6    7    8    9         
     
      10             
      
11                 上传单个文件12             
13             
      14             
      
       16                 上传文件：17                 
       18                 
       
19                 
       20             
      
21         
     
22         
     
23         
     
      24             
      
25                 上传多个文件26             
27             
      28             
      
       30                 上传文件：31                 
       32                 
       
33                 上传文件：34                 
       35                 
       
36                 
       37             
      
38         
     
39     40 

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
     
       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控件(
      )的名字直接获取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实现文件上传功能是非常方便的。