JavaWeb实现文件上传、下载功能

前言

在Web应用系统开发中，文件上传和下载功能是非常常用的功能，今天来讲一下JavaWeb中的文件上传和下载功能的实现。

对于文件上传，浏览器在上传的过程中是将文件以流的形式提交到服务器端的，如果直接使用Servlet获取上传文件的输入流然后再解析里面的请求参数是比较麻烦，所以一般选择采用apache的开源工具common-fileupload这个文件上传组件。这个common-fileupload上传组件的jar包可以去apache官网上面下载，也可以在struts的lib文件夹下面找到，struts上传的功能就是基于这个实现的。common-fileupload是依赖于common-io这个包的，所以还需要下载这个包。

一、开发环境搭建

创建一个FileUploadAndDownLoad项目，加入Apache的commons-fileupload文件上传组件的相关Jar包，如下图所示：

项目路径

二、实现文件上传

2.1、文件上传页面和消息提示页面

upload.jsp页面的代码如下：
<pre>
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>文件上传</title>
</head>

message.jsp的代码如下：
<pre>
<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>消息提示</title>
</head>

<body>
${message}
</body>
</html>
</pre>

2.2、处理文件上传的Servlet

文件上传功能有许多需要注意的小细节问题，以下列出的几点需要特别注意:

1、为保证服务器安全，上传文件应该放在外界无法直接访问的目录下，比如放于WEB-INF目录下。
　　2、为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名。
　　3、为防止一个目录下面出现太多文件，要使用hash算法打散存储。
　　4、要限制上传文件的最大值。
　　5、要限制上传文件的类型，在收到上传文件名时，判断后缀名是否合法。

UploadHandleServlet的代码如下：
<pre>
package me.gacl.web.controller;

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.FileUploadBase;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

/**

@ClassName: UploadHandleServlet
@Description: TODO(这里用一句话描述这个类的作用)
@author: 孤傲苍狼
@date: 2015-1-3 下午11:35:50

*/
public class UploadHandleServlet extends HttpServlet {

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//得到上传文件的保存目录，将上传的文件存放于WEB-INF目录下，不允许外界直接访问，保证上传文件的安全
String savePath = this.getServletContext().getRealPath("/WEB-INF/upload");
//上传时生成的临时文件保存目录
String tempPath = this.getServletContext().getRealPath("/WEB-INF/temp");
File tmpFile = new File(tempPath);
if (!tmpFile.exists()) {
//创建临时目录
tmpFile.mkdir();
}

 //消息提示
 String message = "";
 try{
  //使用Apache文件上传组件处理文件上传步骤：
  //1、创建一个DiskFileItemFactory工厂
  DiskFileItemFactory factory = new DiskFileItemFactory();
  //设置工厂的缓冲区的大小，当上传的文件大小超过缓冲区的大小时，就会生成一个临时文件存放到指定的临时目录当中。
  factory.setSizeThreshold(1024*100);//设置缓冲区的大小为100KB，如果不指定，那么缓冲区的大小默认是10KB
  //设置上传时生成的临时文件的保存目录
  factory.setRepository(tmpFile);
  //2、创建一个文件上传解析器
  ServletFileUpload upload = new ServletFileUpload(factory);
  //监听文件上传进度
  upload.setProgressListener(new ProgressListener(){
   public void update(long pBytesRead, long pContentLength, int arg2) {
    System.out.println("文件大小为：" + pContentLength + ",当前已处理：" + pBytesRead);
    /**
    * 文件大小为：14608,当前已处理：4096
     文件大小为：14608,当前已处理：7367
     文件大小为：14608,当前已处理：11419
     文件大小为：14608,当前已处理：14608
    */
   }
  });
  //解决上传文件名的中文乱码
  upload.setHeaderEncoding("UTF-8"); 
  //3、判断提交上来的数据是否是上传表单的数据
  if(!ServletFileUpload.isMultipartContent(request)){
   //按照传统方式获取数据
   return;
  }
   
  //设置上传单个文件的大小的最大值，目前是设置为1024*1024字节，也就是1MB
  upload.setFileSizeMax(1024*1024);
  //设置上传文件总量的最大值，最大值=同时上传的多个文件的大小的最大值的和，目前设置为10MB
  upload.setSizeMax(1024*1024*10);
  //4、使用ServletFileUpload解析器解析上传数据，解析结果返回的是一个List<FileItem>集合，每一个FileItem对应一个Form表单的输入项
  List<FileItem> list = upload.parseRequest(request);
  for(FileItem item : list){
   //如果fileitem中封装的是普通输入项的数据
   if(item.isFormField()){
    String name = item.getFieldName();
    //解决普通输入项的数据的中文乱码问题
    String value = item.getString("UTF-8");
    //value = new String(value.getBytes("iso8859-1"),"UTF-8");
    System.out.println(name + "=" + value);
   }else{//如果fileitem中封装的是上传文件
    //得到上传的文件名称，
    String filename = item.getName();
    System.out.println(filename);
    if(filename==null || filename.trim().equals("")){
     continue;
    }
    //注意：不同的浏览器提交的文件名是不一样的，有些浏览器提交上来的文件名是带有路径的，如： c:\a\b\1.txt，而有些只是单纯的文件名，如：1.txt
    //处理获取到的上传文件的文件名的路径部分，只保留文件名部分
    filename = filename.substring(filename.lastIndexOf("\\")+1);
    //得到上传文件的扩展名
    String fileExtName = filename.substring(filename.lastIndexOf(".")+1);
    //如果需要限制上传的文件类型，那么可以通过文件的扩展名来判断上传的文件类型是否合法
    System.out.println("上传的文件的扩展名是："+fileExtName);
    //获取item中的上传文件的输入流
    InputStream in = item.getInputStream();
    //得到文件保存的名称
    String saveFilename = makeFileName(filename);
    //得到文件的保存目录
    String realSavePath = makePath(saveFilename, savePath);
    //创建一个文件输出流
    FileOutputStream out = new FileOutputStream(realSavePath + "\\" + saveFilename);
   //创建一个缓冲区
    byte buffer[] = new byte[1024];
    //判断输入流中的数据是否已经读完的标识        int len = 0;
    //循环将输入流读入到缓冲区当中，(len=in.read(buffer))>0就表示in里面还有数据
    while((len=in.read(buffer))>0){
     //使用FileOutputStream输出流将缓冲区的数据写入到指定的目录(savePath + "\\" + filename)当中
     out.write(buffer, 0, len);
    }
    //关闭输入流
    in.close();
    //关闭输出流
    out.close();        //删除处理文件上传时生成的临时文件        //item.delete();        message = "文件上传成功！";
   }
  }
 }catch (FileUploadBase.FileSizeLimitExceededException e) {
  e.printStackTrace();
  request.setAttribute("message", "单个文件超出最大值！！！");
  request.getRequestDispatcher("/message.jsp").forward(request, response);
  return;
 }catch (FileUploadBase.SizeLimitExceededException e) {
  e.printStackTrace();
  request.setAttribute("message", "上传文件的总的大小超出限制的最大值！！！");
  request.getRequestDispatcher("/message.jsp").forward(request, response);
  return;
 }catch (Exception e) {
  message= "文件上传失败！";
  e.printStackTrace();
 }
 request.setAttribute("message",message);
 request.getRequestDispatcher("/message.jsp").forward(request, response);

}

/**

@Method: makeFileName
@Description: 生成上传文件的文件名，文件名以：uuid+"_"+文件的原始名称
@Anthor:孤傲苍狼
@param filename 文件的原始名称
@return uuid+""+文件的原始名称
*/
private String makeFileName(String filename){ //2.jpg
//为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名
return UUID.randomUUID().toString() + "" + filename;
}
/**
为防止一个目录下面出现太多文件，要使用hash算法打散存储
@Method: makePath
@Description:
@Anthor:孤傲苍狼
@param filename 文件名，要根据文件名生成存储目录
@param savePath 文件存储路径
@return 新的存储目录
*/
private String makePath(String filename,String savePath){
//得到文件名的hashCode的值，得到的就是filename这个字符串对象在内存中的地址
int hashcode = filename.hashCode();
int dir1 = hashcode&0xf; //0--15
int dir2 = (hashcode&0xf0)>>4; //0-15
//构造新的保存目录
String dir = savePath + "\" + dir1 + "\" + dir2; //upload\2\3 upload\3\5
//File既可以代表文件也可以代表目录 File file = new File(dir);
//如果目录不存在
if(!file.exists()){
//创建目录
file.mkdirs();
}
return dir;
}

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

doGet(request, response);
}
}
</pre>

在Web.xml文件中注册UploadHandleServlet
<pre>
<servlet>
<servlet-name>UploadHandleServlet</servlet-name>
<servlet-class>me.gacl.web.controller.UploadHandleServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>UploadHandleServlet</servlet-name>
<url-pattern>/servlet/UploadHandleServlet</url-pattern>
</servlet-mapping>
</pre>

以上就可以实现一个简单的文件上传功能了。

=============== 这只是分割线 ===================

三、实现文件下载

3.1、列出提供下载的文件资源

我们要将Web应用系统中的文件资源提供给用户进行下载，首先我们要有一个页面列出上传文件目录下的所有文件，当用户点击文件下载超链接时就进行下载操作，编写一个ListFileServlet，用于列出Web应用系统中所有下载文件。

ListFileServlet的代码如下：
<pre>
package me.gacl.web.controller;

import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**

@ClassName: ListFileServlet
@Description: 列出Web系统中所有下载文件
@author: 孤傲苍狼
@date: 2015-1-4 下午9:54:40

*/
public class ListFileServlet extends HttpServlet {

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//获取上传文件的目录
String uploadFilePath = this.getServletContext().getRealPath("/WEB-INF/upload");
//存储要下载的文件名
Map<String,String> fileNameMap = new HashMap<String,String>();
//递归遍历filepath目录下的所有文件和目录，将文件的文件名存储到map集合中
listfile(new File(uploadFilePath),fileNameMap);//File既可以代表一个文件也可以代表一个目录
//将Map集合发送到listfile.jsp页面进行显示
request.setAttribute("fileNameMap", fileNameMap);
request.getRequestDispatcher("/listfile.jsp").forward(request, response);
}

/**

@Method: listfile
@Description: 递归遍历指定目录下的所有文件
@Anthor:孤傲苍狼
@param file 即代表一个文件，也代表一个文件目录
@param map 存储文件名的Map集合
/
public void listfile(File file,Map<String,String> map){
//如果file代表的不是一个文件，而是一个目录
if(!file.isFile()){
//列出该目录下的所有文件和目录
File files[] = file.listFiles();
//遍历files[]数组
for(File f : files){
//递归
listfile(f,map);
}
}else{
/*
处理文件名，上传后的文件是以uuid_文件名的形式去重新命名的，去除文件名的uuid_部分
file.getName().indexOf("")检索字符串中第一次出现""字符的位置，如果文件名类似于：9349249849-88343-8344_阿凡达.avi
那么file.getName().substring(file.getName().indexOf("")+1)处理之后就可以得到阿凡达.avi部分
*/
String realName = file.getName().substring(file.getName().indexOf("")+1);
//file.getName()得到的是文件的原始名称，这个名称是唯一的，因此可以作为key，realName是处理过后的名称，有可能会重复
map.put(file.getName(), realName);
}
}

public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
</pre>

这里简单说一下ListFileServlet中listfile方法，listfile方法是用来列出目录下的所有文件的，listfile方法内部用到了递归，在实际开发当中，我们肯定会在数据库创建一张表，里面会存储上传的文件名以及文件的具体存放目录，我们通过查询表就可以知道文件的具体存放目录，是不需要用到递归操作的，这个例子是因为没有使用数据库存储上传的文件名和文件的具体存放位置，而上传文件的存放位置又使用了散列算法打散存放，所以需要用到递归，在递归时，将获取到的文件名存放到从外面传递到listfile方法里面的Map集合当中，这样就可以保证所有的文件都存放在同一个Map集合当中。

在Web.xml文件中配置ListFileServlet

<pre>
<servlet>
<servlet-name>ListFileServlet</servlet-name>
<servlet-class>me.gacl.web.controller.ListFileServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>ListFileServlet</servlet-name>
<url-pattern>/servlet/ListFileServlet</url-pattern>
</servlet-mapping>
</pre>

展示下载文件的listfile.jsp页面如下
<pre>
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<!DOCTYPE HTML>
<html>
<head>
<title>下载文件显示页面</title>
</head>

<body>

<c:forEach var="me" items="${fileNameMap}">
<c:url value="/servlet/DownLoadServlet" var="downurl">
<c:param name="filename" value="${me.key}"></c:param>
</c:url>
${me.value}<a href="${downurl}">下载</a>

</c:forEach>
</body>
</html>
</pre>

访问ListFileServlet，就可以在listfile.jsp页面中显示提供给用户下载的文件资源，如下图所示：

下载列表

3.2、实现文件下载

编写一个用于处理文件下载的Servlet，DownLoadServlet的代码如下：

<pre>
package me.gacl.web.controller;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.net.URLEncoder;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class DownLoadServlet extends HttpServlet {

public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//得到要下载的文件名
String fileName = request.getParameter("filename"); //23239283-92489-阿凡达.avi
fileName = new String(fileName.getBytes("iso8859-1"),"UTF-8");
//上传的文件都是保存在/WEB-INF/upload目录下的子目录当中
String fileSaveRootPath=this.getServletContext().getRealPath("/WEB-INF/upload");
//通过文件名找出文件的所在目录
String path = findFileSavePathByFileName(fileName,fileSaveRootPath);
//得到要下载的文件
File file = new File(path + "\" + fileName);
//如果文件不存在
if(!file.exists()){
request.setAttribute("message", "您要下载的资源已被删除！！");
request.getRequestDispatcher("/message.jsp").forward(request, response);
return;
}
//处理文件名
String realname = fileName.substring(fileName.indexOf("_")+1);
//设置响应头，控制浏览器下载该文件
response.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(realname, "UTF-8"));
//读取要下载的文件，保存到文件输入流
FileInputStream in = new FileInputStream(path + "\" + fileName);
//创建输出流
OutputStream out = response.getOutputStream();
//创建缓冲区
byte buffer[] = new byte[1024];
int len = 0;
//循环将输入流中的内容读取到缓冲区当中
while((len=in.read(buffer))>0){
//输出缓冲区的内容到浏览器，实现文件下载
out.write(buffer, 0, len);
}
//关闭文件输入流
in.close();
//关闭输出流
out.close();
}

/**

@Method: findFileSavePathByFileName
@Description: 通过文件名和存储上传文件根目录找出要下载的文件的所在路径
@Anthor:孤傲苍狼
@param filename 要下载的文件名
@param saveRootPath 上传文件保存的根目录，也就是/WEB-INF/upload目录
@return 要下载的文件的存储目录
*/
public String findFileSavePathByFileName(String filename,String saveRootPath){
int hashcode = filename.hashCode();
int dir1 = hashcode&0xf; //0--15
int dir2 = (hashcode&0xf0)>>4; //0-15
String dir = saveRootPath + "\" + dir1 + "\" + dir2; //upload\2\3 upload\3\5
File file = new File(dir);
if(!file.exists()){
//创建目录
file.mkdirs();
}
return dir;
}

public void doPost(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
doGet(request, response);
}
}
</pre>

在Web.xml文件中配置DownLoadServlet

<pre>
<servlet>
<servlet-name>DownLoadServlet</servlet-name>
<servlet-class>me.gacl.web.controller.DownLoadServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>DownLoadServlet</servlet-name>
<url-pattern>/servlet/DownLoadServlet</url-pattern>
</servlet-mapping>
</pre>

点击【下载】超链接，将请求提交到DownLoadServlet就行处理就可以实现文件下载了,文件下载的操作到这里就可以简单实现了。

最后编辑于：2017.12.06 03:56:31

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 158,736评论 4赞 362
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 67,167评论 1赞 291
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 108,442评论 0赞 243
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 43,902评论 0赞 204
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 52,302评论 3赞 287
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 40,573评论 1赞 216
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 31,847评论 2赞 312
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 30,562评论 0赞 197
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 34,260评论 1赞 241
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 30,531评论 2赞 245
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 32,021评论 1赞 258
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 28,367评论 2赞 253
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 33,016评论 3赞 235
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 26,068评论 0赞 8
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 26,827评论 0赞 194
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 35,610评论 2赞 274
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 35,514评论 2赞 269