Servlet 3.0新特性——文件上传接口

 Servlet 3.0之前的版本中，文件上传是个挺让人头疼的问题，虽然有第三方框架来实现，但使用也还是比较麻烦，在Servlet 3.0中，这些问题将不复存在，Servlet 3.0对文件上传提供了直接支持，配合Servlet 3.0中基于Annotations的配置，大大简化上传件的操作。今天做了个小demo，测试了写Servlet 3.0的文件上传功能。 
    1.写文件上传的服务端（Servlet ），将上传文件全都保存到指定配置的目录下面，转向上传文件列表的显示页面。 

package com.neusoft.servlet3.demo; import java.io.IOException; import java.util.Collection; import java.util.Iterator; import java.util.LinkedList; import java.util.List; import java.util.regex.Matcher; import java.util.regex.Pattern; import javax.servlet.ServletException; import javax.servlet.annotation.MultipartConfig; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import javax.servlet.http.Part; /** * Servlet implementation class FileUploadServlet */ @WebServlet( description = "文件上传", urlPatterns = { "/upload" } ) @MultipartConfig( location = "E://upload",//文件存放路径，指定的目录必须存在，否则会抛异常 maxFileSize = 8388608,//最大上传文件大小,经测试应该是字节为单位 fileSizeThreshold = 819200//当数据量大于该值时，内容将被写入文件。（specification中的解释的大概意思，不知道是不是指Buffer size），大小也是已字节单位 //maxRequestSize = 8*1024*1024*6 //针对该 multipart/form-data 请求的最大数量，默认值为 -1，表示没有限制。以字节为单位。 ) public class FileUploadServlet extends HttpServlet { private static final long serialVersionUID = 1L; private String fileNameExtractorRegex = "filename=/".+/""; /** * @see HttpServlet#HttpServlet() */ public FileUploadServlet() { super(); } /** * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response) */ protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { throw new UnsupportedOperationException(); } /** * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response) */ protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { List<String> fileNames = new LinkedList<String>(); request.setCharacterEncoding("UTF-8"); Collection<Part> parts = request.getParts(); //遍历所有的表单内容，将表单中的文件写入上传文件目录 for (Iterator<Part> iterator = parts.iterator(); iterator.hasNext();) { Part part = iterator.next(); //从Part的content-disposition中提取上传文件的文件名 String fileName = getFileName(part); if(fileName!=null){ fileNames.add(fileName); part.write(fileName); } } request.setAttribute("fileNames", fileNames); //显示上传的文件列表 request.getRequestDispatcher("upload_files_list.jsp").forward(request, response); } /** * 从Part的Header信息中提取上传文件的文件名 * @param part * @return 上传文件的文件名，如果如果没有则返回null */ private String getFileName(Part part){ //获取header信息中的content-disposition，如果为文件，则可以从其中提取出文件名 String cotentDesc = part.getHeader("content-disposition"); String fileName = null; Pattern pattern = Pattern.compile(fileNameExtractorRegex); Matcher matcher = pattern.matcher(cotentDesc); if(matcher.find()){ fileName = matcher.group(); fileName = fileName.substring(10, fileName.length()-1); } return fileName; } } 

 

2.上传文件jsp页面(fileupload.jsp)代码片段，enctype必须申明为multipart/form-data，否则Servlet 会抛异常！ 

<form action="upload" method="post" enctype="multipart/form-data"> <fieldset> <label>File1:</label><input type="file" name="file1"/><br/> <label>File2:</label><input type="file" name="file2"/><br/> <label>File3:</label><input type="file" name="file3"/><br/> <label>File4:</label><input type="file" name="file4"/><br/> <label>File5:</label><input type="file" name="file5"/> </fieldset> <input type="submit" name="submit" value="upload"/> </form> 

Servlet 3.0的文件上传功能确实好用，只等Java EE 6普及了，到时候就可以抛弃Commons-FileUpload了！不过Servlet 3.0的文件上传接口也有不足指出，比如不能直接获取上传的文件的文件名，MultipartConfig信息好像也没有提供接口直接获取，我查了好半天没找到，当然没有这些功能也有好处的，那就是带来简单易用接口……当实际有需要的时候再写点扩展的工具类就OK了。 
    Servlet 3.0还提供了很多其他新功能，最吸引人当然就是对异步处理的支持，有空再研究研究…… 

 

3.上传文件列表显示页面(upload_files_list.jsp)代码片段。 

<p>上传了${fn:length(fileNames) }几个文件 </p> <c:if test="${not empty fileNames }"> <ul> <c:forEach var="fileName" items="${fileNames }"> <li>${fileName}</li> </c:forEach> </ul> </c:if>