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>