Apache 文件上传与文件下载案例详解
(编辑：jimmy 日期: 2024/11/17 浏览：3 次 )
写一个Apache文件上传与文件下载的案例：以供今后学习
web.xml配置如下：
<span style="font-family:SimSun;font-size:14px;"><"1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5">
<display-name>FileUploadAndDownload</display-name>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
<welcome-file>index.htm</welcome-file>
<welcome-file>index.jsp</welcome-file>
<welcome-file>default.html</welcome-file>
<welcome-file>default.htm</welcome-file>
<welcome-file>default.jsp</welcome-file>
</welcome-file-list>
<!-- 上传配置 -->
<servlet>
<servlet-name>uploadHandleServlet</servlet-name>
<servlet-class>com.zeng.controller.UploadHandleServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>uploadHandleServlet</servlet-name>
<url-pattern>/upload/uploadHandleServlet</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>listFileServlet</servlet-name>
<servlet-class>com.zeng.controller.ListFileServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>listFileServlet</servlet-name>
<url-pattern>/listFileServlet</url-pattern>
</servlet-mapping>
<servlet>
<servlet-name>downLoadServlet</servlet-name>
<servlet-class>com.zeng.controller.DownLoadServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>downLoadServlet</servlet-name>
<url-pattern>/download/downLoadServlet</url-pattern>
</servlet-mapping>
</web-app></span>
2.upload.jsp文件
<span style="font-family:SimSun;font-size:14px;"><%@page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>文件上传</title>
</head>
<body>
<!--
${pageContext.request.contextPath} : 作用是取出部署的应用程序名
缺点:操作不便，其他工具无法正确解释${pageContext.request.contextPath}
如果Servlet的配置路径为 /upload/uploadHandleServlet
action跳转路径为: ${pageContext.request.contextPath}/upload/uploadHandleServlet
上传文件时,必须
1.enctype="multipart/form-data"
2.method=post
-->
<form action="${pageContext.request.contextPath}/upload/uploadHandleServlet" enctype="multipart/form-data" method="post">
上传用户：<input type="text" name="username"><br/>
上传文件1：<input type="file" name="file1"><br/>
上传文件2：<input type="file" name="file2"><br/>
<input type="submit" value="提交">
</form>
</body>
</html></span>
3.message.jsp
<span style="font-family:SimSun;font-size:14px;"><%@page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>消息提示</title>
</head>
<body>
${message}
</body>
</html></span>
4.UploadHandleServlet.java
<span style="font-family:SimSun;font-size:14px;">package com.zeng.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(这里用一句话描述这个类的作用)
*/
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 + ",arg2: " + arg2);
/**
* 文件大小为：14608,当前已处理：4096
文件大小为：14608,当前已处理：7367
文件大小为：14608,当前已处理：11419
文件大小为：14608,当前已处理：14608
*/
}
});
//解决上传文件名的中文乱码
upload.setHeaderEncoding("UTF-8");
//3、判断提交上来的数据是否是上传表单的数据
if(!ServletFileUpload.isMultipartContent(request)){
//按照传统方式获取数据
return;
}
//设置上传单个文件的大小的最大值，目前是设置为1024*1024*20字节，也就是20MB
upload.setFileSizeMax(1024*1024*20);
//设置上传文件总量的最大值，最大值=同时上传的多个文件的大小的最大值的和，目前设置为100MB
upload.setSizeMax(1024*1024*100);
//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");
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);
//文件名:d507ef2e-aca9-4908-a8b9-c1d1c6a2f4d9_日语二级语法大全(推荐).doc
//System.out.println("saveFilename: " + saveFilename);
//得到文件的保存目录
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);
//访问路径 /FileUploadAndDownload/upload/upload.jsp
//跳转路径 /FileUploadAndDownload/upload/listFileServlet
//转发路径 /FileUploadAndDownload/message.jsp
//当前路径是在/FileUploadAndDownload/upload/下,要跳到/FileUploadAndDownload/下,必须../message.jsp
//-----如果 message.jsp是在/FileUploadAndDownload/upload/下,则直接使用message.jsp
request.getRequestDispatcher("../message.jsp").forward(request, response);
}
/**
* @Method: makeFileName
* @Description: 生成上传文件的文件名，文件名以：uuid+"_"+文件的原始名称
* @param filename 文件的原始名称
* @return uuid+"_"+文件的原始名称
*/
private String makeFileName(String filename){ //2.jpg
//为防止文件覆盖的现象发生，要为上传文件产生一个唯一的文件名
return UUID.randomUUID().toString() + "_" + filename;
}
/**
* 为防止一个目录下面出现太多文件，要使用hash算法打散存储
* @Method: makePath
* @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
//hashcode: -1390239557 dir1: 11 dir: 11 (以d507ef2e-aca9-4908-a8b9-c1d1c6a2f4d9_日语二级语法大全(推荐).doc为例子)
System.out.println("上传前:hashcode: "+ hashcode + " dir1: " +dir1 + " dir: " + dir2);
//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);
}
}
// ----------------------------------------------------------简单版本,不处理上传空间和上传的文件名
//
//import java.io.File;
//import java.io.FileOutputStream;
//import java.io.IOException;
//import java.io.InputStream;
//import java.util.List;
//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 UploadHandleServlet extends HttpServlet {
//
// public void doGet(HttpServletRequest request, HttpServletResponse response)
// throws ServletException, IOException {
// //得到上传文件的保存目录，将上传的文件存放于WEB-INF目录下，不允许外界直接访问，保证上传文件的安全
// String savePath = this.getServletContext().getRealPath("/WEB-INF/upload");
// File file = new File(savePath);
// //判断上传文件的保存目录是否存在
// if (!file.exists() && !file.isDirectory()) {
// System.out.println(savePath+"目录不存在，需要创建");
// //创建目录
// file.mkdir();
// }
// //消息提示
// String message = "";
// try{
// //使用Apache文件上传组件处理文件上传步骤：
// //1、创建一个DiskFileItemFactory工厂
// DiskFileItemFactory factory = new DiskFileItemFactory();
// //2、创建一个文件上传解析器
// ServletFileUpload upload = new ServletFileUpload(factory);
// //解决上传文件名的中文乱码
// upload.setHeaderEncoding("UTF-8");
// //3、判断提交上来的数据是否是上传表单的数据
// if(!ServletFileUpload.isMultipartContent(request)){
// //按照传统方式获取数据
// return;
// }
// //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);
// //获取item中的上传文件的输入流
// InputStream in = item.getInputStream();
// //创建一个文件输出流
// FileOutputStream out = new FileOutputStream(savePath + "\\" + filename);
// //创建一个缓冲区
// 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 (Exception e) {
// message= "文件上传失败！";
// e.printStackTrace();
//
// }
// request.setAttribute("message",message);
// request.getRequestDispatcher("/message.jsp").forward(request, response);
// }
//
// public void doPost(HttpServletRequest request, HttpServletResponse response)
// throws ServletException, IOException {
//
// doGet(request, response);
// }
//}</span>
<上传文件完毕>
1.listfile.jsp
<span style="font-family:SimSun;font-size:14px;"><%@ 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>
<meta charset="UTF-8">
<style type="text/css">
.filelistTab{
width: 500px;
border: 2px solid gray;
border-collapse: collapse;
}
.filelistTd{
height:25px;
border: 1px solid gray;
}
</style>
</head>
<body>
<%--
<c:url var="path" value="download/downLoadServlet">
<c:param name="filename" value="myOPQ"></c:param>
</c:url>
<a href="${path }" rel="external nofollow" rel="external nofollow" >下载文件</a>
--%>
<!-- 遍历Map集合 -->
<table class="filelistTab">
<c:forEach items="${fileNameMap }" var="fileNames">
<tr>
<td class="filelistTd">
<c:url value="download/downLoadServlet" var="path">
<c:param name="filename" value="${fileNames.key}"></c:param>
</c:url>${fileNames.value}
</td>
<td class="filelistTd"><a href="${path }" rel="external nofollow" rel="external nofollow" >下载</a></td>
</tr>
</c:forEach>
</table>
</body>
</html></span>
2.ListFileServlet.java
<span style="font-family:SimSun;font-size:14px;">package com.zeng.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系统中所有下载文件
*/
public class ListFileServlet extends HttpServlet {
/*
* ListFileServlet中listfile方法，listfile方法是用来列出目录下的所有文件的，
* listfile方法内部用到了递归，在实际开发当中，我们肯定会在数据库创建一张表，
* 里面会存储上传的文件名以及文件的具体存放目录，我们通过查询表就可以知道文件的具体存放目录，
* 是不需要用到递归操作的，这个例子是因为没有使用数据库存储上传的文件名和文件的具体存放位置，
* 而上传文件的存放位置又使用了散列算法打散存放，所以需要用到递归，在递归时，
* 将获取到的文件名存放到从外面传递到listfile方法里面的Map集合当中，
* 这样就可以保证所有的文件都存放在同一个Map集合当中。
* */
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>();
//
File file = new File(uploadFilePath);
if(!file.exists()){
//如果文件路径不存在,则转发
request.setAttribute("message", "路径为空路径");
request.getRequestDispatcher("message.jsp").forward(request, response);
}else{
//如果文件路径存在,则进行遍历所有文件
//递归遍历filepath目录下的所有文件和目录，将文件的文件名存储到map集合中
listfile(file,fileNameMap);//File既可以代表一个文件也可以代表一个目录
//将Map集合发送到listfile.jsp页面进行显示
request.setAttribute("fileNameMap", fileNameMap);
request.getRequestDispatcher("listfile.jsp").forward(request, response);
}
}
/**
* @Method: listfile
* @Description: 递归遍历指定目录下的所有文件
* @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);
}
}</span>
<展示完毕>
1.DownLoadServlet.Java
<span style="font-family:SimSun;font-size:14px;">package com.zeng.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 {
System.out.println("进入");
/*
* fileName的格式:文件名以：uuid+"_"+文件的原始名称
* 得到fileName:d507ef2e-aca9-4908-a8b9-c1d1c6a2f4d9_日语二级语法大全(推荐).doc
*
* listfile.jsp的路径传递是以 download/downLoadServlet提交
*
* 路径内容为:
* /FileUploadAndDownload/download/downLoadServlet
* "filename");
// 注意:使用了下面一句字符转码时,出错:打不到文件,
//dir1和dir2的数字前后各不相同,导致重新创建了文件,而文件内又没有文件,故报找不到文件错误
//fileName = new String(fileName.getBytes("iso8859-1"),"UTF-8");
System.out.println("fileName: " + fileName);
//上传的文件都是保存在/WEB-INF/upload目录下的子目录当中
String fileSaveRootPath=this.getServletContext().getRealPath("/WEB-INF/upload");
System.out.println("fileSaveRootPath: "+ fileSaveRootPath);
//通过文件名找出文件的所在目录
String path = findFileSavePathByFileName(fileName,fileSaveRootPath);
System.out.println("path: "+ path);
//服务器安装位置\wtpwebapps\FileUploadAndDownload\WEB-INF\ upload\11\11
//得到要下载的文件,文件类型是 : uuid + "_" + 文件名
File file = new File(path + "\\" + fileName);
System.out.println("file: "+ file.getAbsolutePath());
//如果文件不存在
if(!file.exists()){
request.setAttribute("message", "您要下载的资源已被删除！！");
//转发到错误页面,此处要注意路径问题
request.getRequestDispatcher("../message.jsp").forward(request, response);
return;
}
//处理文件名,得到去除uuid后的文件名
String realname = fileName.substring(fileName.indexOf("_")+1);
System.out.println("realname: "+ realname);
/*
* 文件下载
* 设置content-disposition响应头控制浏览器以下载的形式打开文件
* 下载中文文件时，需要注意的地方就是中文文件名要使用
* URLEncoder.encode()方法进行编码(URLEncoder.encode(fileName, "字符编码"))，
* 否则会出现文件名乱码。
* */
response.setHeader("content-disposition", "attachment;filename=" + URLEncoder.encode(realname, "UTF-8"));
//读取要下载的文件，保存到文件输入流,此处的路径还是带有uuid
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: 通过文件名和存储上传文件根目录找出要下载的文件的所在路径
* @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
//hashcode: -1390239557 dir1: 11 dir: 11 (以d507ef2e-aca9-4908-a8b9-c1d1c6a2f4d9_日语二级语法大全(推荐).doc为例子)
System.out.println("hashcode: "+ hashcode + " dir1: " +dir1 + " dir: " + dir2);
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);
}
}</span>
以上所述是小编给大家介绍的Apache 文件上传与文件下载案例详解，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对网站的支持！
下一篇：Nginx配置多个HTTPS域名的方法