JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

阿新 • • 發佈：2019-01-02

在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頁面的程式碼如下：

<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>檔案上傳</title>
</head>

<body>
<form action="${pageContext.request.contextPath}/servlet/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>

message.jsp的程式碼如下：

<%@ page language="java" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>訊息提示</title>
</head>

<body>
${message}
</body>

</html>

2.2、處理檔案上傳的Servlet

　　UploadHandleServlet的程式碼如下：

}

在Web.xml檔案中註冊UploadHandleServlet

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

2.3、檔案上傳的細節

　　上述的程式碼雖然可以成功將檔案上傳到伺服器上面的指定目錄當中，但是檔案上傳功能有許多需要注意的小細節問題，以下列出的幾點需要特別注意的

　　1、為保證伺服器安全，上傳檔案應該放在外界無法直接訪問的目錄下，比如放於WEB-INF目錄下。

　　2、為防止檔案覆蓋的現象發生，要為上傳檔案產生一個唯一的檔名。

　　3、為防止一個目錄下面出現太多檔案，要使用hash演算法打散儲存。

　　4、要限制上傳檔案的最大值。

　　5、要限制上傳檔案的型別，在收到上傳檔名時，判斷後綴名是否合法。

　　針對上述提出的5點細節問題，我們來改進一下UploadHandleServlet，改進後的程式碼如下：

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(這裡用一句話描述這個類的作用)
* @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+"_"+檔案的原始名稱
* @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);
}

}

針對上述提出的5點小細節問題進行改進之後，我們的檔案上傳功能就算是做得比較完善了。

三、檔案下載

3.1、列出提供下載的檔案資源

　　我們要將Web應用系統中的檔案資源提供給使用者進行下載，首先我們要有一個頁面列出上傳檔案目錄下的所有檔案，當用戶點選檔案下載超連結時就進行下載操作，編寫一個ListFileServlet，用於列出Web應用系統中所有下載檔案。

　　ListFileServlet的程式碼如下：

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系統中所有下載檔案
* @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: 遞迴遍歷指定目錄下的所有檔案
* @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);
}

}

　這裡簡單說一下ListFileServlet中listfile方法，listfile方法是用來列出目錄下的所有檔案的，listfile方法內部用到了遞迴，在實際開發當中，我們肯定會在資料庫建立一張表，裡面會儲存上傳的檔名以及檔案的具體存放目錄，我們通過查詢表就可以知道檔案的具體存放目錄，是不需要用到遞迴操作的，這個例子是因為沒有使用資料庫儲存上傳的檔名和檔案的具體存放位置，而上傳檔案的存放位置又使用了雜湊演算法打散存放，所以需要用到遞迴，在遞迴時，將獲取到的檔名存放到從外面傳遞到listfile方法裡面的Map集合當中，這樣就可以保證所有的檔案都存放在同一個Map集合當中。

　　在Web.xml檔案中配置ListFileServlet

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

展示下載檔案的listfile.jsp頁面如下：

<%@ 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>
<br/>
</c:forEach>
</body>

</html>

3.2、實現檔案下載

　　編寫一個用於處理檔案下載的Servlet，DownLoadServlet的程式碼如下：

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: 通過檔名和儲存上傳檔案根目錄找出要下載的檔案的所在路徑
* @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);
}
}

在Web.xml檔案中配置DownLoadServlet

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

其他參考文章：

http://blog.csdn.net/gplihf/article/details/52128225

JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

http://blog.csdn.net/u013087513/article/details/57911383

表單form的enctype="multipart/form-data"使用體會

http://www.blogjava.net/xyzroundo/articles/186217.html

JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

一、開發環境搭建

二、實現檔案上傳

2.1、檔案上傳頁面和訊息提示頁面

2.2、處理檔案上傳的Servlet

2.3、檔案上傳的細節

三、檔案下載

3.1、列出提供下載的檔案資源

3.2、實現檔案下載

JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

JavaWeb之檔案上傳與下載詳解

Spring Boot 整合之檔案上傳與下載

Struts2之檔案上傳與下載

Java Web 之檔案上傳與下載

七、Struts2之檔案上傳與下載

C# 之 FTP伺服器中檔案上傳與下載（二）

SpringMVC整合Mybatis之檔案上傳與下載

extjs列表中檔案上傳與下載（帶有重新命名操作）

檔案上傳與下載（Commons-fileupload）

Java進階學習第十三天（檔案上傳與下載、JavaMail郵件開發）

PHP強化之13 - 檔案上傳與下載

javaWeb學習記錄：檔案上傳與下載

javaweb檔案上傳與下載

struts2實現檔案上傳與下載功能

Spring Boot——檔案上傳與下載

java web檔案上傳與下載

struts2 檔案上傳與下載

struts的檔案上傳與下載

java：檔案上傳與下載

JAVAWEB開發之檔案的上傳與下載（開源元件commons-fileupload的詳細使用）

一、開發環境搭建

二、實現檔案上傳

2.1、檔案上傳頁面和訊息提示頁面

2.2、處理檔案上傳的Servlet

2.3、檔案上傳的細節

三、檔案下載

3.1、列出提供下載的檔案資源

3.2、實現檔案下載

相關推薦