---
title: "文件的上传"
author: "mywebcode"
date: "2012-11-29T21:22:00Z"
tags: []
slug: "untitled"
draft: false
lastmod: "2013-05-08T10:12:39Z"
id: 1862393
url: "https://mywebcode.iteye.com/blog/1862393"
---

## 文件上传概述

实现web开发中的文件上传功能，需完成如下二步操作：  
在web页面中添加上传输入项  
在servlet中读取上传文件的数据，并保存到本地硬盘中。  
如何在web页面中添加上传输入项?  
&lt;input type=“file”&gt;标签用于在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组件工作流程

![](http://img.my.csdn.net/uploads/201211/29/1354194867_9677.png)

## 核心API—DiskFileItemFactory

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

## 核心API—ServletFileUpload

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

## 上传文件的处理细节

中文文件乱码问题  
文件名中文乱码问题，可调用ServletUpLoader的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方法得到数据输入流，从而读取上传数据。  
具体编码如下：

```
//upload.jsp

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%
String path = request.getContextPath();
String basePath = request.getScheme()+"://"+request.getServerName()+":"+request.getServerPort()+path+"/";
%>

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
  <head>
    
    <title>My JSP 'upload.jsp' starting page</title>

  </head>
  
  <body>
  <form action="servlet/UploadServlet" enctype="multipart/form-data" method="post"> 
  上传用户：<input type="text" name="username"/><br/>
  上传文件1：<input type="file" name="f1"/><br/>
  上传文件2：<input type="file" name="f2"/><br/>
  <input type="submit" value="点击上传"/>
  </form>
  </body>
</html>
```

```
//UploadServlet.java

package com.hbsi.servlet;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

public class UploadServlet extends HttpServlet {

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
try{
//1.创建一个解析器工厂
DiskFileItemFactory factory=new DiskFileItemFactory();
//获取临时文件路径
String tempPath=this.getServletContext().getRealPath("/temp");
factory.setRepository(new File(tempPath));
//2.得到一个解析器
ServletFileUpload upload=new ServletFileUpload(factory);
upload.setHeaderEncoding("UTF-8");
//3.将请求传入解析器，对请求进行解析
List<FileItem> list=upload.parseRequest(request);
//4.迭代list集合，得到每个输入项的数据
for(FileItem item:list){
//5.判断item的类型
if(item.isFormField()){
//普通输入项
String inputName=item.getFieldName();
//String inputValue=item.getString("UTF-8");相当于下边两句
String inputValue=item.getString();
inputValue= new String(inputValue.getBytes("iso8859-1"),"UTF-8");

System.out.println(inputName+"="+inputValue);
}else{
//上传输入项
String fileName=item.getName();//获取文件名
if(!fileName.equals("")){
    fileName=fileName.substring(fileName.lastIndexOf("\\")+1);
  String saveName=this.generateFileName(fileName);
    InputStream in=item.getInputStream();
    String savePath=this.getServletContext().getRealPath("WEB-INF/upload");
    String savePaths=this.generateFilePath(savePath,fileName);
    FileOutputStream out=new FileOutputStream(savePaths+"\\"+fileName);
    byte[] buf=new byte[1024];
    int len=0;
    while((len=in.read(buf))>0){
out.write(buf,0,len);
    }
    in.close();
    out.close();
    item.delete();//删除临时文件
    }
}
request.setAttribute("message", "上传成功");

}
}catch(Exception e){
e.printStackTrace();
request.setAttribute("message", "上传失败");
}
request.getRequestDispatcher("/message.jsp").forward(request, response);
}
public String generateFileName(String filename){
return UUID.randomUUID().toString()+"_"+filename;
}
public String generateFilePath(String path,String filename){
int dir1 =filename.hashCode()& 0xf;
int dir2 =(filename.hashCode()>>4) &0xf;

String savePath = path+"\\"+dir1+"\\"+dir2;
File f = new File(savePath);
if(!f.exists()){
f.mkdirs();
}	
return savePath;
}

public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {

doGet(request, response);
}

}
```