commnsUpload1.2用户指南.doc

Commons FileUpload User Guide 翻译版
声明
英文原版版权© 2002-2008 The Apache Software Foundation
本文非官方中文版,是本文翻译者自愿翻译,与The Apache Software Foundation无任何关系。
mons 。
Copyright 2010 王丛琳放弃本翻译版本除署名权外的一切权利。
翻译完成时间1月22日。
如您对翻译有异议,或发现翻译错误,敬请不吝赐教。Email:@

使用FileUpload
FileUplaod 可以根据你的应用程序的要求,以各种方式使用。最简单的方式是,你调用一个方法来解析servlet request,然后根据您的应用程序的要求,处理上传表单。当然,你也可以配置FileUpload以适应不同的要求。例如,你可能要求将表单项或上传文件存储到数据库。
本教程只有是FileUpload的基本语法和简单常用的使用配置和方法。其他的定制方式放在这儿。
mons IO, mons IO的版本是否在兼容列表上。
原理
文件上传请求是根据RFC 1867 ,"Form-based File Upload in HTML" 编写的有序的列表(List)。 FileUpload 能解析这样的请求并提供给你的应用程序一个特制的上传项目列表。这些特制的项目,都实现了FileItem接口,屏蔽了底层实现。
mons Fileupload 库的传统API。传统的API更方便,但如果要求更高的性能,你可能需要更快的Streaming API。
应用程序可能需要上传的文件的一些属性。例如,文件名、文件类型、使用InputStream访问的文件数据。当上传文件表单含有像text box的普通的HTML标签时,你可以根据FileItem接口中提供的方法,区分处理文件和普通标签数据。
FileUpload使用FileItemFactory工厂创建新项目。这给了FileUpload很大的灵活性。这个工厂控制着每个项目的生成和根据当前加载的项目的大小,决定将项目的数据存储到内存还是硬盘。当然,你可以根据需要定制。

Servlets and Portlets
,FileUplaod同时支持servlet和portlet环境。由于在这两种环境下使用方法几乎相同,所以本文只提到servlet环境。

如果你使用portlet,那么你应该阅读下面两点不同:
l 请用PortletFileUplaod类替换ServletFileUpload类。
l 请用ActionRequest类替换HttpServletRequest类。

解析请求
上传项目之前,你需要解析请求,确保它是一个真正的(actually)文件上传请求。FileUpload提供了一个静态方法,使你可以轻易做到。
// Check that we have a file upload request
boolean isMultipart = (request);
现在,我们已经准备好解析请求的构成。
最简单的示例
最简单的示例要求如下:
l 上传文件应尽可能小的放在内存中。
l 较大的文件上传进行时,使用硬盘上的临时文件存储。
l 拒绝很大的文件上传请求。
l 允许指定内存中的最大值、上传文件大小的最大值和临时文件的位置。

处理这个示例中处理请求不能像下面这样简单:
// Create a factory for disk-based file items
FileItemFactory factory = new DiskFileItemFactory();

// Create a new file upload handler
ServletFileUpload upload = new ServletFileUpload(factory);

// Parse the request
List /* FileItem */ items = (request);
这些都是必须的。准备好了!
解析的最后将返回一个含有实现了FileItem 接口的项目的列表(List)。下面将讨论处理这些项目。

使用更多功能
如果你的要求接近上面的示例,但要求还要多一点,你可以很容易的定制上传处理的行为和文件项目工厂(file item factory)。下面的例子展现了几个配置选项。

// Create