Servlet3.0

六、HttpServletRequest 对文件上传的支持

此前,对于处理上传文件的操作一直是让开发者头疼的问题,因为Servlet 本身没有对此提供直接的支持,需要使用第三方框架来实现,而且使用起来也不够简单。如今这都成为了历史,Servlet 3.0已经提供了这个功能,而且使用也非常简单。为此,HttpServletRequest提供了两个方法用于从请求中解析出上传的文件:

Part getPart(String name)

Collection<Part> getParts()

前者用于获取请求中给定name的文件,后者用于获取所有的文件。每一个文件用一个javax.servlet.http.Part对象来表示。该接口提供了处理文件的简易方法,比如write()、delete()等。至此,结合HttpServletRequest和Part来保存上传的文件变得非常简单,如下所示:

Part photo = request.getPart("photo");

photo.write("/tmp/photo.jpg");

// 可以将两行代码简化为 request.getPart("photo").write("/tmp/photo.jpg") 一行。

另外,开发者可以配合前面提到的@MultipartConfig注解来对上传操作进行一些自定义的配置,比如限制上传文件的大小,以及保存文件的路径等。其用法非常简单,故不在此赘述了。

需要注意的是,如果请求的MIME类型不是 multipart/form-data,则不能使用上面的两个方法,否则将抛异常。