文件上傳的功能實現是我們做Web應用時候最為常見的應用場景，比如：實現頭像的上傳，Excel文件數據的導入等功能，都需要我們先實現文件的上傳，然后再做圖片的裁剪，excel數據的解析入庫等后續(xù)操作。

今天通過這篇文章，我們就來一起學習一下如何在Spring Boot中實現文件的上傳。

動手試試

第一步：創(chuàng)建一個基礎的Spring Boot項目，如果還不會的話就先看看這篇《快速入門》。

第二步：在pom.xml中引入模版引擎依賴：

<dependency>
????<groupId>org.springframework.bootgroupId>
????<artifactId>spring-boot-starter-thymeleafartifactId>
dependency>

你也可以選擇其他你熟悉的模版引擎，比如：Freemarker。

第三步：在resources目錄下，創(chuàng)建新目錄templates；在templates目錄下再創(chuàng)建一個文件上傳的頁面upload.html，內容如下：

"en">
????"UTF-8"?/>
????


文件上傳頁面

"post"?action="/upload"?enctype="multipart/form-data">
????選擇要上傳的文件：type="file"?name="file">
????

????type="submit"?value="提交">



????

第四步：創(chuàng)建文件上傳的處理控制器，命名為UploadController

@Slf4j
@Controller
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();
????}

}

其中包含這幾個重要元素：

1. 成員變量path，通過@Value注入配置文件中的file.upload.path屬性。這個配置用來定義文件上傳后要保存的目錄位置。
2. GET請求，路徑/，用于顯示upload.html這個文件上傳頁面。
3. POST請求。路徑/upload，用于處理上傳的文件，即：保存到file.upload.path配置的路徑下面。

注意：這里主要演示文件上傳的主要流程，真實應用還有更多內容要考慮，比如：文件上傳后的文件名處理（防止重名）、分布式情況下文件上傳后如何共享訪問等。更高級的最后，我們后續(xù)文章繼續(xù)講。

第五步：編輯application.properties配置文件

spring.servlet.multipart.max-file-size=2MB
spring.servlet.multipart.max-request-size=2MB

file.upload.path=/Users/didi/

前兩個參數用于限制了上傳請求和上傳文件的大小，而file.upload.path是上面我們自己定義的用來保存上傳文件的路徑。

更多本系列免費教程連載「點擊進入匯總目錄」(https://blog.didispace.com/spring-boot-learning-2x/)

測試驗證

第一步：啟動Spring Boot應用，訪問http://localhost:8080，可以看到如下的文件上傳頁面。

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

你可以根據打印的文件路徑去查看文件是否真的上傳了。

代碼示例

本文的相關例子可以查看下面?zhèn)}庫中的chapter4-3目錄：

* Github：https://github.com/dyc87112/SpringBoot-Learning/
* Gitee：https://gitee.com/didispace/SpringBoot-Learning/

如果您覺得本文不錯，歡迎Star支持，您的關注是我堅持的動力！