使用Servlet技术上传文件

支持文件上传是web程序最基本和常见的需求。在早期的servlet规范中，实现文件上传须要使用第三方库或者复杂的输入处理。针对此问题，servlet如今以通用和可移植的方式帮助提供了一个可行的解决方案。servlet技术如今提供开箱即用的上传文件方法，因此任何实现规范的web容器都能经过HttpServletRequest 对象解析multipart请求和生成有效的mime附件。
一个新的注解，javax.servlet.annotation.MultipartConfig，用来代表须要multipart/form-data类型请求的定义上。使用@MultipartConfig注解的servlet均可以经过调用 request.getPart(String name)或request.getParts()方法获取一个给定的multipart/form-data请求中的Part构件。

@MultipartConfig注解

@MultipartConfig注解提供下面这些可选的属性：

• location 操做系统上的一个绝对路径。location属性不支持基于web上下文的相对路径。location用来在处理Part时存储临时文件或者是文件大小超过fileSizeThreshold设置的值。默认location是“”
• fileSizeThreshold 存储在硬盘上的临时文件的大小。默认是0byte
• MaxFileSize 容许上传的最大文件大小，单位是byte。若是上传的文件超过限制，web容器将抛出异常（IllegalStateException）。默认设置是不限制大小。
• maxRequestSize 一个 multipart/form-data请求能携带的最大字节数。

例如，@MultiPartConfig能够以下构造：

@MultipartConfig(location="/tmp", fileSizeThreshold=1024*1024,
    maxFileSize=1024*1024*5, maxRequestSize=1024*1024*5*5)

代替使用 @MultipartConfig注解在你的upload servlet中硬编码这些属性，须要在web.xml中做为一个子节点添加下面的节点：

<multipart-config>
    <location>/tmp</location>
    <max-file-size>20848820</max-file-size>
    <max-request-size>418018841</max-request-size>
    <file-size-threshold>1048576</file-size-threshold>
</multipart-config>

getParts和getPart方法

servlet规范定义了HttpServletRequest的两个附加方法：

• Collection<Part> getParts()
• Part getPart(String name)

request.getParts()方法返回全部Prat集合。若是你有超过一个文件类型的输入，将返回多个Part对象。由于全部Part对象都被命名， getPart(String name)方法用来访问特定的Part对象。另外，getParts()返回Iterable<Part>能够用来遍历全部Part。
javax.servlet.http.Part是简单的，提供每一个Part的自省方法。方法列表：

• 获取Part的名称、大小、类型等
• 查询随Part提交的Header信息
• 删除一个Part
• 输出Part到磁盘

例如，Part 接口提供write(String filename) 方法以特定名称写入到文件中。文件能够使用@MultipartConfig注解定义的location直接保存，在fileupload示例中，location是由表达中的属性定义的。