第一步：創建一個基礎的Spring Boot項目，如果還不會的話就先看看這篇《快速入門》open in new window。
第二步：在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="提交">
</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目錄：
