FileUpload组件实现文件上传

文件上传概述

实现web开发中的文件上传功能，需完成如下二步操作：
一、在web页面中添加上传输入项

二、在servlet中读取上传文件的数据，并保存到本地硬盘中。

如何在web页面中添加上传输入项?
<input type=“file”>标签用于在web页面中添加文件上传输入项，设置文件上传输入项时须注意：
1、必须要设置input输入项的name属性，否则浏览器将不会发送上传文件的数据。
２、必须把form的enctype属值设为multipart/form-data.设置该值后，浏览器在上传文件时，将把文件数据附带在http请求消息体中，并使用ＭＩＭＥ协议对上传的文件进行描述，以方便接收方对上传数据进行解析和处理。

如何在Servlet中读取文件上传数据，并保存到本地硬盘中?
Request对象提供了一个getInputStream方法，通过这个方法可以读取到客户端提交过来的数据。但由于用户可能会同时上传多个文件，在servlet端编程直接读取上传数据，并分别解析出相应的文件数据是一项非常麻烦的工作，示例。
为方便用户处理文件上传数据，Apache 开源组织提供了一个用来处理表单文件上传的一个开源组件（ Commons-fileupload ），该组件性能优异，并且其API使用极其简单，可以让开发人员轻松实现web文件上传功能，因此在web开发中实现文件上传功能，通常使用Commons-fileupload组件实现。
使用Commons-fileupload组件实现文件上传，需要导入该组件相应的支撑jar包：Commons-fileupload和commons-io。commons-io 不属于文件上传组件的开发jar文件，但Commons-fileupload 组件从1.1 版本开始，它工作时需要commons-io包的支持。

fileupload组件工作流程

核心API—DiskFileItemFactory

DiskFileItemFactory 是创建 FileItem 对象的工厂，这个工厂类常用方法：
public void setSizeThreshold(int sizeThreshold) ：设置内存缓冲区的大小，默认值为10K。当上传文件大于缓冲区大小时， fileupload组件将使用临时文件缓存上传文件。
public void setRepository(java.io.File repository) ：指定临时文件目录，默认值为System.getProperty("java.io.tmpdir").
public DiskFileItemFactory(int sizeThreshold, java.io.File repository) ：构造函数

核心API—ServletFileUpload

ServletFileUpload 负责处理上传的文件数据，并将表单中每个输入项封装成一个 FileItem 对象中。常用方法有：
boolean isMultipartContent(HttpServletRequest request) ：判断上传表单是否为multipart/form-data类型
List parseRequest(HttpServletRequest request)：解析request对象，并把表单中的每一个输入项包装成一个fileItem 对象，并返回一个保存了所有FileItem的list集合。 
setFileSizeMax(long fileSizeMax) ：设置上传文件的最大值
setSizeMax(long sizeMax) ：设置上传文件总量的最大值
setHeaderEncoding(java.lang.String encoding) ：设置编码格式
setProgressListener(ProgressListener pListener) 

上传文件的处理细节

中文文件乱码问题
文件名中文乱码问题，可调用ServletFileUpload的setHeaderEncoding方法，或者设置request的setCharacterEncoding属性 
临时文件的删除问题
由于文件大小超出DiskFileItemFactory.setSizeThreshold方法设置的内存缓冲区的大小时，Commons-fileupload组件将使用临时文件保存上传数据，因此在程序结束时，务必调用FileItem.delete方法删除临时文件。
Delete方法的调用必须位于流关闭之后，否则会出现文件占用，而导致删除失败的情况。

文件存放位置
为保证服务器安全，上传文件应保存在应用程序的WEB-INF目录下，或者不受WEB服务器管理的目录。
为防止多用户上传相同文件名的文件，而导致文件覆盖的情况发生，文件上传程序应保证上传文件具有唯一文件名。
为防止单个目录下文件过多，影响文件读写速度，处理上传文件的程序应根据可能的文件上传总量，选择合适的目录结构生成算法，将上传文件分散存储。

ProgressListener显示上传进度

ProgressListener progressListener = new ProgressListener() {
 public void update(long pBytesRead, long pContentLength, int pItems) {

 System.out.println("到现在为止,  " + pBytesRead + " 字节已上传，总大小为 "
     + pContentLength);
 }
};
upload.setProgressListener(progressListener);

以KB为单位显示上传进度
long temp = -1;   //temp注意设置为类变量
long ctemp = pBytesRead /1024; 
if (mBytes == ctemp)  
 return; 
temp = mBytes;

文件上传案例

实现步骤
１、创建DiskFileItemFactory对象，设置缓冲区大小和临时文件目录
２、使用DiskFileItemFactory 对象创建ServletFileUpload对象，并设置上传文件的大小限制。
３、调用ServletFileUpload.parseRequest方法解析request对象，得到一个保存了所有上传内容的List对象。
４、对list进行迭代，每迭代一个FileItem对象，调用其isFormField方法判断是否是上传文件
为普通表单字段，则调用getFieldName、getString方法得到字段名和字段值
为上传文件，则调用getInputStream方法得到数据输入流，从而读取上传数据。
具体编码如下：

1. 1. try{  
   2. //1创建一个解析器工厂  
   3. DiskFileItemFactory factory=new DiskFileItemFactory();  
   4. //获取临时文件路径  
   5. String tempPath=this.getServletContext().getRealPath("/temp");  
   6. factory.setRepository(new File(tempPath));  
   7. //2.得到一个解析器  
   8. ServletFileUpload upload=new ServletFileUpload(factory);  
   9. upload.setHeaderEncoding("UTF-8");  
   10. //3.将请求传入解析器，对请求进行解析  
   11. List<FileItem> list=upload.parseRequest(request);  
   12. //4.迭代list集合，得到每个输入项的数据  
   13. for(FileItem item:list){  
   14.       //5.判断item的类型  
   15.     if(item.isFormField()){  
   16.               //普通输入项  
   17.         String inputName=item.getFieldName();  
   18.         //String inputValue=item.getString("UTF-8");相当于下边两句  
   19.         String inputValue=item.getString();  
   20.     inputValue= new String(inputValue.getBytes("iso8859-1"),"UTF-8");  
   21.  
   22.               System.out.println(inputName+"="+inputValue);  
   23.              }else{  
   24.         //上传输入项  
   25.               String fileName=item.getName();//获取文件名  
   26.               if(!fileName.equals("")){  
   27.     fileName=fileName.substring(fileName.lastIndexOf("\\")+1);  
   28.                          String saveName=this.generateFileName(fileName);  
   29.                     InputStream in=item.getInputStream();  
   30.                      String savePath="";
   31.                                  savePath=this.getServletContext().getRealPath("WEB-INF/upload");  
   32.                          String savePaths=this.generateFilePath(savePath,saveName);  
   33.                            FileOutputStream out=new FileOutputStream(savePaths+"\\"+saveName);    
   34.                           byte[] buf=new byte[1024];  
   35.                                 int len=0;  [
   36.                                 while((len=in.read(buf))>0){  
   37.                                         out.write(buf,0,len);  
   38.                                 }  
   39.                                 in.close();  
   40.                                 out.close();  
   41.                                 item.delete();//删除临时文件  
   42.              }  
   43.               }  
   44.         request.setAttribute("message", "上传成功");  
   45.   
   46.          }  
   47.      }catch(Exception e){  
   48.          e.printStackTrace();  
   49.         request.setAttribute("message", "上传失败");  
   50.     }  
   51.        request.getRequestDispatcher("/message.jsp").forward(request, response);  
   52.   }  
   53. 
       
   54.   public String generateFileName(String filename){  
   55.             return UUID.randomUUID().toString()+"_"+filename;  
   56.   }  
   57.   public String generateFilePath(String path,String filename){  
   58.           int dir1 =filename.hashCode()& 0xf;  
   59.               int dir2 =(filename.hashCode()>>4) &0xf;  
   60.   
   61.              String savePath = path+"\\"+dir1+"\\"+dir2;  
   62.              File f = new File(savePath);  
   63.             if(!f.exists()){  
   64.                     f.mkdirs();  
   65.             }     
   66.           return savePath;  
   67.    }  
   68.   
   69.   public void doPost(HttpServletRequest request, HttpServletResponse response)  
   70.           throws ServletException, IOException {  
   71.   
   72.         doGet(request, response);  
   73.    } 
   74.  }  

 

[java] view plain copy

1. //UploadServlet.java  
2.   
3. package com.hbsi.servlet;  
4.   
5. import java.io.File;  
6. import java.io.FileOutputStream;  
7. import java.io.IOException;  
8. import java.io.InputStream;  
9. import java.util.List;  
10. import java.util.UUID;  
11.   
12. import javax.servlet.ServletException;  
13. import javax.servlet.http.HttpServlet;  
14. import javax.servlet.http.HttpServletRequest;  
15. import javax.servlet.http.HttpServletResponse;  
16.   
17. import org.apache.commons.fileupload.FileItem;  
18. import org.apache.commons.fileupload.disk.DiskFileItemFactory;  
19. import org.apache.commons.fileupload.servlet.ServletFileUpload;  
20.   
21. public class UploadServlet extends HttpServlet {  
22.   
23. public void doGet(HttpServletRequest request, HttpServletResponse response)  
24. throws ServletException, IOException {  
25.