使用apache.commons.fileupload 进行文件上传

一 主要API

1. DiskFileUpload类
DiskFileUpload类是Apache文件上传组件的核心类，应用程序开发人员通过这个类来与Apache文件上传组件进行交互。下面介绍DiskFileUpload类中的几个常用的重要方法。
1.1．setSizeMax方法
setSizeMax方法用于设置请求消息实体内容的最大允许大小，以防止客户端故意通过上传特大的文件来塞满服务器端的存储空间，单位为字节。其完整语法定义如下：
     public void setSizeMax（long sizeMax）
如果请求消息中的实体内容的大小超过了setSizeMax方法的设置值，该方法将会抛出FileUploadException异常。
1.2．setSizeThreshold方法
setSizeThreshold方法用于设置是否使用临时文件保存解析出的数据的那个临界值，该方法传入的参数的单位是字节。其完整语法定义如下：
     public void setSizeThreshold(int sizeThreshold)
1.3. setRepositoryPath方法
setRepositoryPath方法用于设置setSizeThreshold方法中提到的临时文件的存放目录，这里要求使用绝对路径。其完整语法定义如下：
     public void setRepositoryPath(String repositoryPath)
如果不设置存放路径，那么临时文件将被储存在"java.io.tmpdir"这个JVM环境属性所指定的目录中，tomcat 5.5.9将这个属性设置为了“<tomcat安装目录>/temp/”目录。
1.4. parseRequest方法
parseRequest 方法是DiskFileUpload类的重要方法，它是对HTTP请求消息进行解析的入口方法，如果请求消息中的实体内容的类型不是“multipart/form-data”，该方法将抛出FileUploadException异常。parseRequest 方法解析出FORM表单中的每个字段的数据，并将它们分别包装成独立的FileItem对象，然后将这些FileItem对象加入进一个List类型的集合对象中返回。parseRequest 方法的完整语法定义如下：
      public List parseRequest(HttpServletRequest req)
parseRequest 方法还有一个重载方法，该方法集中处理上述所有方法的功能，其完整语法定义如下：
      parseRequest(HttpServletRequest req,int sizeThreshold,long sizeMax,
             String path)
这两个parseRequest方法都会抛出FileUploadException异常。
2.  FileItem类
FileItem类用来封装单个表单字段元素的数据，一个表单字段元素对应一个FileItem对象，通过调用FileItem对象的方法可以获得相关表单字段元素的数据。 下面介绍FileItem类中的几个常用的方法：
2.1. isFormField方法
isFormField方法用于判断FileItem类对象封装的数据是否属于一个普通表单字段，还是属于一个文件表单字段，如果是普通表单字段则返回true，否则返回false。该方法的完整语法定义如下：
      public boolean isFormField()
2.2. getName方法
getName方法用于获得文件上传字段中的文件名，getName方法的完整语法定义如下：
      public String getName()
注意：如果用户使用Windows系统上传文件，浏览器将传递该文件的完整路径，如果用户使用Linux或者Unix系统上传文件，浏览器将只传递该文件的名称部分。
2.3. write方法
write方法用于将FileItem对象中保存的主体内容保存到某个指定的文件中。如果FileItem对象中的主体内容是保存在某个临时文件中，该方法顺利完成后，临时文件有可能会被清除。该方法也可将普通表单字段内容写入到一个文件中，但它主要用途是将上传的文件内容保存在本地文件系统中。其完整语法定义如下：
      public void write(File file)

二．上传实例

1. // Create a factory for disk-based file items
2. DiskFileItemFactory factory = new DiskFileItemFactory();
3. // Set factory constraints
4. factory.setSizeThreshold(4096); // 设置缓冲区大小，这里是4kb
5. factory.setRepository(tempPathFile);// 设置缓冲区目录
6. // Create a new file upload handler
7. ServletFileUpload upload = new ServletFileUpload(factory);
8. // Set overall request size constraint
9. upload.setSizeMax(4*1024*1024); // 设置最大文件尺寸，这里是4MB
10. List<FileItem> items = upload.parseRequest(request);// 得到所有的文件
11. Iterator<FileItem> i = items.iterator();
12. while (i.hasNext()) {
13.      FileItem fi = (FileItem) i.next();
14.      String fileName = fi.getName();
15.      if (fileName != null) {
16.           File fullFile = new File(fi.getName());
17.           File savedFile = new File(uploadPath, fullFile.getName());
18.           fi.write(savedFile);
19.       }
20. }

 

 

reference:

http://zhangjunhd.blog.51cto.com/113473/18331

http://blogger.org.cn/blog/more.asp?name=zhanglincon&id=31865