檔案上傳的功能實作是我們做Web應用時候最為常見的應用場景,比如:實作頭像的上傳,Excel檔案資料的匯入等功能,都需要我們先實作檔案的上傳,然后再做圖片的裁剪,excel資料的決議入庫等后續操作,
今天通過這篇文章,我們就來一起學習一下如何在Spring Boot中實作檔案的上傳,
動手試試
第一步:創建一個基礎的Spring Boot專案,如果還不會的話就先看看這篇《快速入門》,
第二步:在pom.xml中引入模版引擎依賴:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
你也可以選擇其他你熟悉的模版引擎,比如:Freemarker,
第三步:在resources目錄下,創建新目錄templates;在templates目錄下再創建一個檔案上傳的頁面upload.html,內容如下:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8" />
<title>檔案上傳頁面</title>
</head>
<body>
<h1>檔案上傳頁面</h1>
<form method="post" action="/upload" enctype="multipart/form-data">
選擇要上傳的檔案:<input type="file" name="file"><br>
<hr>
<input type="submit" value="https://www.cnblogs.com/didispace/p/提交">
</form>
</body>
</html>
第四步:創建檔案上傳的處理控制器,命名為UploadController
@Controller
@Slf4j
public class UploadController {
@Value("${file.upload.path}")
private String path;
@GetMapping("/")
public String uploadPage() {
return "upload";
}
@PostMapping("/upload")
@ResponseBody
public String create(@RequestPart MultipartFile file) throws IOException {
String fileName = file.getOriginalFilename();
String filePath = path + fileName;
File dest = new File(filePath);
Files.copy(file.getInputStream(), dest.toPath());
return "Upload file success : " + dest.getAbsolutePath();
}
}
其中包含這幾個重要元素:
- 成員變數
path,通過@Value注入組態檔中的file.upload.path屬性,這個配置用來定義檔案上傳后要保存的目錄位置, - GET請求,路徑
/,用于顯示upload.html這個檔案上傳頁面, - POST請求,路徑
/upload,用于處理上傳的檔案,即:保存到file.upload.path配置的路徑下面,
注意:這里主要演示檔案上傳的主要流程,真實應用還有更多內容要考慮,比如:檔案上傳后的檔案名處理(防止重名)、分布式情況下檔案上傳后如何共享訪問等,更高級的最后,我們后續文章繼續講,
第五步:編輯application.properties組態檔
spring.servlet.multipart.max-file-size=2MB
spring.servlet.multipart.max-request-size=2MB
file.upload.path=/Users/didi/
前兩個引數用于限制了上傳請求和上傳檔案的大小,而file.upload.path是上面我們自己定義的用來保存上傳檔案的路徑,
更多本系列免費教程連載「點擊進入匯總目錄」
測驗驗證
第一步:啟動Spring Boot應用,訪問http://localhost:8080,可以看到如下的檔案上傳頁面,

第二步:選擇一個不大于2MB的檔案,點擊“提交”按鈕,完成上傳,
如果上傳成功,將顯示類似下面的頁面:

你可以根據列印的檔案路徑去查看檔案是否真的上傳了,
代碼示例
本文的相關例子可以查看下面倉庫中的chapter4-3目錄:
- Github:https://github.com/dyc87112/SpringBoot-Learning/
- Gitee:https://gitee.com/didispace/SpringBoot-Learning/
如果您覺得本文不錯,歡迎Star支持,您的關注是我堅持的動力!
歡迎關注我的公眾號:程式猿DD,獲得獨家整理的免費學習資源助力你的Java學習之路!另每周贈書不停哦~
轉載請註明出處,本文鏈接:https://www.uj5u.com/houduan/245944.html
標籤:Java
