日期:2014-05-16  浏览次数:20902 次

Apache的FileUpload类
一、类的简介

Web资源:
引用
FileUpload主页:http://commons.apache.org/fileupload/
Commons IO类库:http://commons.apache.org/io/ ,FileUpload需要用于该类库,所以你确保该类库在您的classpath中,否则会出现异常。

在得到上传文件之前,首先要判断客户端<form>标记的enctype属性是否是“multipart/form-data",可使用org.apache.commons.fileupload.servlet.ServletFileUpload类中的isMultipartContent()方法进行进行判断,该方法定义如下:

static boolean isMultipartContent(javax.servlet.http.HttpServletRequest request)  
static boolean isMultipartContent(javax.servlet.http.HttpServletRequest request) 

示例:
import org.apache.commons.fileupload.servlet.ServletFileUpload;   
  
//....................   
  
  
if(ServletFileUpload.isMultipartContent(request)){   
//该提示符合文件上传规则,在此处对文件上传数据进行处理。   
}else{   
//该表单不符合文件上传规则,另作处理。   
}   
  
  
//....................  
import org.apache.commons.fileupload.servlet.ServletFileUpload;

//....................


if(ServletFileUpload.isMultipartContent(request)){
//该提示符合文件上传规则,在此处对文件上传数据进行处理。
}else{
//该表单不符合文件上传规则,另作处理。
}


//.................... 


DiskFileItemFactory 类,实现了FileItemFactory,根据名字翻译就是”文件项工厂”,实际作用是定义文件传过程中文件占用的内存,及超过占用内存时临时文件的存储地点,主要方法如下:

void setSizeThreshold(int sizeThreshold) //以byte为单位设定文件使用多少内存量后,将文件存入临时存储。   
void setRepository(java.io.File repository) //设定临时文件的存储路径  
void setSizeThreshold(int sizeThreshold) //以byte为单位设定文件使用多少内存量后,将文件存入临时存储。
void setRepository(java.io.File repository) //设定临时文件的存储路径



ServletFileUpload类,处理同一HTML文件中多文件上传的类,继承自FileUpload,主要方法如下:


static boolean isMultipartContent(javax.servlet.http.HttpServletRequest request)   
     //判断客户端请求是否为POST,并且enctype属性是否是“multipart/form-data"   
 
public java.util.List parseRequest(javax.servlet.http.HttpServletRequest request)    
     throws FileUploadException //读入“multipart/form-data"数据流,并得到表单项列表。   
  
void setSizeMax(long sizeMax)  //设置允许上传文件的最大大小  
static boolean isMultipartContent(javax.servlet.http.HttpServletRequest request)
      //判断客户端请求是否为POST,并且enctype属性是否是“multipart/form-data"

public java.util.List parseRequest(javax.servlet.http.HttpServletRequest request) 
     throws FileUploadException //读入“multipart/form-data"数据流
,并得到表单项列表。

void setSizeMax(long sizeMax)  //设置允许上传文件的最大大小



FileItem类,是一个接口,根据名字翻译就是文件项,代表所提交表单中的一个控件,ServletFileUpload中的parseRequest()文件返回整个表单的所有FileItem项的列表。

boolean isFormField()  //判断该表单项是否是文件项,还是普通表单项。   
 
String getFieldName() //如果不是文件项,返回对应表单项的表单名称。   
 
String getString() //如果不是文件项,以默认编码返回该项的内容。   
 
String getString(String encoding) //以指定编码返回该项内容。   
  
long getSize() //以byte为单位返回该项大小   
  
String getName() //如果是文件项,该方法返回文件名,文件名取决于客户端浏览器   
 
void write(java.io.File file) //如果是文件项,将该文件写入对应的文件中   
 
java.io.InputStream getInputStream()   

java.io.OutputStream getOutputStream()  
boolean isFormField()  //判断该表单项是否是文件项,还是普通表单项。

String getFieldName() //如果不是文件项,返回对应表单项的表单名称。

String getString() //如果不是文件项,以默认编码返回该项的内容。

String getString(String encoding) //以指定编码返回该项内容。

long getSize() //以byte为单位返回该项大小

String getName() //如果是文件项,该方法返回文件名,文件名取决于客户端浏览器

void write(java.io.File file) //如果是文件项,将该文件写入对应的文件中

java.io.InputStream getInputStream()

java.io.OutputStream getOutputStream() 




一个简单的示例,运行文件并保存到D盘某个目录下:
 
//文件上传示例程序   
//判断表单是否是 enctype="multipart/form-data"   
if(ServletFileUpload.isMultipartContent(request)){   
                  
                DiskFileItemFactory dfif = new DiskFileItemFactory();   
                dfif.setSizeThreshold(5 * 1024 * 1024); //设定使用内存超过5M时,将产生临时文件并存储于临时目录中。   
                dfif.setRepository(new File("c:\\temp")); //设定存储临时文件的目