利用Apache的FileUpload类库实现文件上传

Apache的FileUpload用于Servlet与JSP环境下的文件上传。

 

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)

 

示例：

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) //设定临时文件的存储路径

 

ServletFileUpload类，处理同一ＨＴＭＬ文件中多文件上传的类，继承自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)  //设置允许上传文件的最大大小

 

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()

 

 

一个简单的示例，运行文件并保存到Ｄ盘某个目录下：

//文件上传示例程序
//判断表单是否是 enctype="multipart/form-data"
if(ServletFileUpload.isMultipartContent(request)){
                
                DiskFileItemFactory dfif = new DiskFileItemFactory();
                dfif.setSizeThreshold(5 * 1024 * 1024); //设定使用内存超过5M时，将产生临时文件并存储于临时目录中。
                dfif.setRepository(new File("c:\\temp")); //设定存储临时文件的目录。
                
                ServletFileUpload fileupload = new ServletFileUpload(dfif);
                fileupload.setSizeMax(50 * 1024 * 1024); //设定最大允许上传50M的文件。
                
                List<FileItem> files = fileupload.parseRequest(request);
                for(FileItem f:files){
                    if(f.isFormField()){ //如果该项是表单项，不是文件上传项
                        out.print(f.getFieldName());
                        out.print(f.getString("UTF-8")); //因为Web使用是的UTF-8编码，所以客户端返回的也是UTF-8的编码。
                    }else{
                        String filename = f.getName();
                        filename = filename.substring(filename.lastIndexOf("."));
                        f.write(new File("d:\\upfile\\" + (int)(Math.random()*10000000) + filename)); //别学我，偷懒行为
                    }
                }
}else{
                out.print("你所提交的表单有错误！");
}

 

如果了处理文件的输入流，可能参考手册的FileItemIterator类。