java组件fileupload

Fileupload：

　FileUpload 是 Apache commons下面的一个子项目，用来实现java环境下面的文件上传功能，与常见的SmartUpload齐名。

组件：

　　组件FileUpload依赖于Commons IO组件，因此在继续之前，要确保在你的工程classpath中有描述页中提到的相应版本。（这里FileUpload版本为：commons- fileupload-1.2.1，Commons IO版本为：commons-io-1.4）；

即在创建工程项目时，你需要导入必要的包：

　　Apache-fileupload.jar – 文件上传核心包。

　　Apache-commons-io.jar – 这个包是fileupload的依赖包。同时又是一个工具包。

当有了这几个包，才能拥有使用组件的必要环境。

其中包中核心的类有：

　　DiskFileItemFactory – 设置磁盘空间，保存临时文件。只是一个具类。

　　ServletFileUpload  － 文件上传的核心类，此类接收request,并解析reqeust

　　ServletFileUpload.parseRequest(request);  --List<FileItem>   解析request

工作原理：

　　上传文件的要求包括一个基于RFC 1867编码的选项列表清单；组件FileUpload可以解析这个上传的请求，并给你的应用程序提供一份独立上传的项目清单。

　　每一个文件项目都有一些属性并能用inputStream访问其数据

　　数据来源的表单域不同处理项目的方式也会不同，FileItem接口可以提供处理这一问题的方法。

　　组件FileUpload使用FileItemFactory工厂创建新的文件项目。这个给了组件FileUpload很大的灵活性。这个工厂拥有怎样创建项目的最终控制权。工厂执行过程中上传项目文件的临时数据可以存储在内存中或硬盘上。这个依赖于上传项目的大小。不过这种方法可以在你的应用程序中自定义。

解析：

　　在实现上传项目之前，当然需要解析这个请求。确保这个请求的确是一个正确的上传文件，组件FileUpload为了使这个判断简单，提供了一个静态的方法去做这个事情。

　　// 检测我们是否一个文件上传的请求

　　boolean isMultipart = ServletFileUpload.isMultipartContent(request);

实例

最简单的使用情况如下：

1. 上传项目只要足够小，就应该将其保存在内存中。
2. 较大的项目应该被写入到硬盘的临时文件中。
3. 应该避免有非常大的上传项目。
4. 设置项目默认的在内存中所占的空间，限制最大的上传请求，并设定临时文件 的位置。

处理这种情况下的请求非常的简单：

　　// 创建磁盘工厂

　　FileItemFactory factory = new DiskFileItemFactory();

　　// 创建处理工具

　　ServletFileUpload upload = new ServletFileUpload(factory);

　　// 解析

　　List <FileItem> items = upload.parseRequest(request);

这就是我们真正需要的全部代码。

处理的结果是生成了一个文件项目列表，每个文件项目实现一个FileItem接口。下面将介绍如何处理这些项目。

控制：

　　如果你的使用情况和上面描述的例子很接近，但是你需要在一点更多的控制限定文件的大小或临时文件的存放位置。你可以很容易的自定义上传实例或文件项目或两者的行为。下面例子展示了几种配置选项：

　　// 创建磁盘工厂

　　DiskFileItemFactory factory = new DiskFileItemFactory();

　　// 设置参数

　　factory.setSizeThreshold(yourMaxMemorySize);

　　factory.setRepository(yourTempDirectory);

　　// 创建处理工具

　　ServletFileUpload upload = new ServletFileUpload(factory);

　　// 设置最大允许的尺寸

　　upload.setSizeMax(yourMaxRequestSize);

　　// 解析

　　List <FileItem> items = upload.parseRequest(request);

当然，每一个配置处理方法都是独立于其他方法的，但是如果你想一次性配置这个工厂，你可以使用工厂的另一个重载方法。像这样：

DiskFileItemFactory factory = new DiskFileItemFactory( yourMaxMemorySize, 　　　　yourTempDirectory);

如果你还需要更多的控制请求的解析，比如存储项目到其它地方（如：数据库），你将需要看看FileUpload自定义。