servlet-文件上传：DiskFileItemFactory

原文地址：http://blog.csdn.net/wenzhihui_2010/article/details/39397837

一。文件上传概述

l  实现web开发中的文件上传功能，需完成如下二步操作：

•    在web页面中添加上传输入项

•    在servlet中读取上传文件的数据，并保存到本地硬盘中。

l  如何在web页面中添加上传输入项?

•    <input type=“file”>标签用于在web页面中添加文件上传输入项，设置文件上传输入项时须注意：

•    1、必须要设置input输入项的name属性，否则浏览器将不会发送上传文件的数据。

•    ２、必须把form的enctype属值设为multipart/form-data.设置该值后，浏览器在上传文件时，将把文件数据附带在http请求消息体中，并使用ＭＩＭＥ协议对上传的文件进行描述，以方便接收方对上传数据进行解析和处理。

l  如何在Servlet中读取文件上传数据，并保存到本地硬盘中?

•    Request对象提供了一个getInputStream方法，通过这个方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件，在servlet端编程直接读取上传数据，并分别解析出相应的文件数据是一项非常麻烦的工作，示例。

•    为方便用户处理文件上传数据，Apache 开源组织提供了一个用来处理表单文件上传的一个开源组件（Commons-fileupload ），该组件性能优异，并且其API使用极其简单，可以让开发人员轻松实现web文件上传功能，因此在web开发中实现文件上传功能，通常使用Commons-fileupload组件实现。

l  使用Commons-fileupload组件实现文件上传，需要导入该组件相应的支撑jar包：Commons-fileupload和commons-io。commons-io 不属于文件上传组件的开发jar文件，但Commons-fileupload 组件从1.1 版本开始，它工作时需要commons-io包的支持。

二。核心API—DiskFileItemFactory

l  DiskFileItemFactory 是创建FileItem 对象的工厂，这个工厂类常用方法：

•    public void setSizeThreshold(int sizeThreshold) ：设置内存缓冲区的大小，默认值为10K。当上传文件大于缓冲区大小时，fileupload组件将使用临时文件缓存上传文件。

•    public void setRepository(java.io.File repository) ：指定临时文件目录，默认值为System.getProperty("java.io.tmpdir").

•    public DiskFileItemFactory(int sizeThreshold,java.io.File repository) ：构造函数

l  ServletFileUpload 负责处理上传的文件数据，并将表单中每个输入项封装成一个FileItem 对象中。常用方法有：

•    boolean isMultipartContent(HttpServletRequest request) ：判断上传表单是否为multipart/form-data类型

•    List parseRequest(HttpServletRequest request)：解析request对象，并把表单中的每一个输入项包装成一个fileItem 对象，并返回一个保存了所有FileItem的list集合。

•    setFileSizeMax(long fileSizeMax) ：设置上传文件的最大值

•    setSizeMax(long sizeMax) ：设置上传文件总量的最大值

•    setHeaderEncoding(java.lang.String encoding) ：设置编码格式

•    setProgressListener(ProgressListener pListener)

三文件上传案例

l  实现步骤

１、创建DiskFileItemFactory对象，设置缓冲区大小和临时文件目录

２、使用DiskFileItemFactory 对象创建ServletFileUpload对象，并设置上传文件的大小限制。

３、调用ServletFileUpload.parseRequest方法解析request对象，得到一个保存了所有上传内容的List对象。

４、对list进行迭代，每迭代一个FileItem对象，调用其isFormField方法判断是否是上传文件

•    为普通表单字段，则调用getFieldName、getString方法得到字段名和字段值

•    为上传文件，则调用getInputStream方法得到数据输入流，从而读取上传数据。