文件上傳
對於文件上傳,都不陌生,但是一寫代碼,博主感覺也很迷,因爲文件上傳的原理過程確實太複雜了,我們一般使用第三方提供的方法來實現。
鑑於原生的文件上傳真的太難了,所以Apache提供了處理文件上傳的jar包(按照以往的習慣,還是提供了Maven倉庫的地址,需要者可以自己去下載)。
博主這裏就直接使用Maven依賴了:
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.6</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
首先,文件上傳一定得需要表單頁面吧,原生頁面,別嫌棄low哈
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>文件上傳</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/upload.do" method="post" enctype="multipart/form-data">
用戶名:<input type="text" name="username"/><br>
文件:<input type="file" name="fileName"/><br>
<input type="submit" value="提交">
</form>
</body>
</html>
上傳文件的表單一定要注意,表單提交方式一定要是post
方式,而且一定要設置enctype="multipart/form-data"
,否則會失敗。
提供處理上傳文件的Servlet:
package cn.ara.servlet;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.ProgressListener;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
import java.util.UUID;
public class FileServlet extends HttpServlet {
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
//判斷上傳的表單是普通表單還是文件表單
if (!ServletFileUpload.isMultipartContent(request)) {
return;//是一個普通的表單
}
try {
//創建上傳文件的保存路徑,直接放在WEB-INF路徑下,安全,用戶無法直接訪問
String uploadPath = this.getServletContext().getRealPath("/WEB-INF/upload");
File uploadFile = new File(uploadPath);
if (!uploadFile.exists()) {
uploadFile.mkdir();//不存在該文件夾就創建
//打印絕對路徑
System.out.println(uploadFile.getAbsolutePath());
}
//緩存 臨時文件
//臨時路徑 如果文件超出預定的大小 就將它放到一個臨時的文件中 一段時間後自動刪除
String tempPath = this.getServletContext().getRealPath("/WEB-INF/temp");
File tempFile = new File(tempPath);
if (!tempFile.exists()) {
tempFile.mkdir();//不存在該文件夾就創建
//打印絕對路徑
System.out.println(tempFile.getAbsolutePath());
}
//處理上傳的文件,一般都需要通過流來獲取,可以使用request. getInputStream(),原生態的文件上:傳流獲取,十分麻煩
//我們一般都建議使用Apache的文件上傳組件來實現,common-fileupload, 它需要依賴於commons- io組件
/*
在使用ServletFileUpload對象解析請求時需要DiskFileItemFactory對象。
所以,我們需要在進行解析工作前構造DiskFileItemFactory對象,
通過ServletFileUpload,對象的構造方法或setFileItemFactory()方法沒置ServLetFileUpload對象的fileItemFactory屬性。
*/
//1.創建DiskFileItemFactory對象,處理文件上: 傳路徑或者大小限制的;
DiskFileItemFactory factory = new DiskFileItemFactory();
//通過這個工廠設置一個緩衝區,當上:傳的文件大於這個緩衝區的時候,將他放到臨時文件中;
factory.setSizeThreshold(1024 * 1024); //緩存區大小爲1M
factory.setRepository(tempFile);//臨時目錄的保存目錄,需要一個File
//2.獲取ServletFileUpload ServletFileUpload負責處理上傳的文件數據,並將表單中每個輸入項封裝成一個FileItem對象
ServletFileUpload upload = new ServletFileUpload(factory);
//監聽文件上傳進度 可以參考實現文件上傳時的進度條
upload.setProgressListener(new ProgressListener() {
@Override
//pBytesRead:已經讀取到的文件大樸
//pContentLength :文件 大樸
public void update(long pBytesRead, long pContentLength, int pItems) {
//總大小 pContentLength
//已上傳大小 pBytesRead
System.out.println("已上傳: " + (pBytesRead*100) /pContentLength + "%");
}
});
//處理亂碼問題
upload.setHeaderEncoding("UTF-8");
//1024=1kb*1024=1M*10=10M
//設置單個文件的最大值
upload.setFileSizeMax(1024 * 1024 * 10);
//設置總共能夠上傳文件的大小
upload.setSizeMax(1024 * 1024 * 10);
//3.處理上傳的文件
//解析前端請求,把表單中的每一個輸入項封裝成一個個的FileItem
List<FileItem> fileItems = upload.parseRequest(request);
//遍歷單個FileItem
for (FileItem fileItem : fileItems) {
//判斷輸入項是一個普通輸入項還是帶文件的輸入項
if (fileItem.isFormField()) {
//是一個普通表單
String name = fileItem.getFieldName();
String value = fileItem.getString("UTF-8");
System.out.println(name + ":" + value);
} else {
//是一個文件輸入項
//============= 處理文件 開始 ===============
//獲取上傳的帶路徑的文件名
String uploadFileName = fileItem.getName();
//如果文件名爲空或者文件名不合法 則捨棄這個輸入項
if (uploadFileName == null || uploadFileName.trim().equals("")) {
continue;
}
//獲得上傳的文件名
String fileName = uploadFileName.substring(uploadFileName.lastIndexOf("/") + 1);
//獲得文件的後綴名
String fileNameSuffix = uploadFileName.substring(uploadFileName.lastIndexOf(".") + 1);
System.out.println("文件信息[文件名:" + fileName + ", 文件類型:" + fileNameSuffix + "]");
//============= 處理文件 結束 ===============
//============= 存放地址 開始 ===============
//使用UUID保證文件夾名的唯一 一個文件對應一個UUID的文件夾
String uuidPath = UUID.randomUUID().toString();
String relPath = uploadPath + "/" + uuidPath;
File relPathFile = new File(relPath);
if (!relPathFile.exists()) {
relPathFile.mkdir();
}
//============= 存放地址 結束 ===============
//============= 文件傳輸 開始 ===============
//獲取輸入項中的流
InputStream inputStream = fileItem.getInputStream();
//創建一個輸出流
FileOutputStream fileOutputStream = new FileOutputStream(relPath + "/" + fileName);
//緩衝區
byte[] buffer = new byte[1024 * 1024];
int len = 0;
while ((len = inputStream.read(buffer)) > 0) {
fileOutputStream.write(buffer, 0, len);
}
//============= 文件傳輸 結束 ===============
//關閉流
fileOutputStream.close();
inputStream.close();
//刪除臨時文件
fileItem.delete();
}
}
} catch (FileUploadException e) {
e.printStackTrace();
}
//響應客戶端
response.getWriter().write("OK!");
}
}
配置好Servlet之後,提交就可以發現上傳的文件被存放到控制檯打印的地址了。
文件上傳就實現成功了。
文件上傳有幾個注意點:
- 爲了保證上傳文件的安全,上傳的文件一般保存在外界無法直接訪問的目錄下。
- 爲了防止文件的重複,應該爲上傳的文件提供一個唯一的文件名。
- 爲了節省服務器的內存資源,上傳的文件通常會限制大小。
- 爲了上傳文件的合法性,一般會通過後綴名限制文件上傳的類型。
一般實際操作就視實際情況而定,博主這裏沒有限制文件上傳的類型,僅供參考。