第一步:創(chuàng)建一個(gè)基礎(chǔ)的Spring Boot項(xiàng)目,如果還不會(huì)的話就先看看這篇《快速入門(mén)》open in new window。
第二步:在pom.xml
中引入模版引擎依賴:
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
你也可以選擇其他你熟悉的模版引擎,比如:Freemarker。
第三步:在resources
目錄下,創(chuàng)建新目錄templates
;在templates
目錄下再創(chuàng)建一個(gè)文件上傳的頁(yè)面upload.html
,內(nèi)容如下:
<!DOCTYPE html>
<html>
<head lang="en">
<meta charset="UTF-8" />
<title>文件上傳頁(yè)面</title>
</head>
<body>
<h1>文件上傳頁(yè)面</h1>
<form method="post" action="/upload" enctype="multipart/form-data">
選擇要上傳的文件:<input type="file" name="file"><br>
<hr>
<input type="submit" value="提交">
</form>
</body>
</html>
第四步:創(chuàng)建文件上傳的處理控制器,命名為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();
}
}
其中包含這幾個(gè)重要元素:
- 成員變量
path
,通過(guò)@Value
注入配置文件中的file.upload.path
屬性。這個(gè)配置用來(lái)定義文件上傳后要保存的目錄位置。 - GET請(qǐng)求,路徑
/
,用于顯示upload.html
這個(gè)文件上傳頁(yè)面。 - POST請(qǐng)求。路徑
/upload
,用于處理上傳的文件,即:保存到file.upload.path
配置的路徑下面。
注意:這里主要演示文件上傳的主要流程,真實(shí)應(yīng)用還有更多內(nèi)容要考慮,比如:文件上傳后的文件名處理(防止重名)、分布式情況下文件上傳后如何共享訪問(wèn)等。更高級(jí)的最后,我們后續(xù)文章繼續(xù)講。
第五步:編輯application.properties
配置文件
spring.servlet.multipart.max-file-size=2MB
spring.servlet.multipart.max-request-size=2MB
file.upload.path=/Users/didi/
前兩個(gè)參數(shù)用于限制了上傳請(qǐng)求和上傳文件的大小,而file.upload.path
是上面我們自己定義的用來(lái)保存上傳文件的路徑。
更多本系列免費(fèi)教程連載「點(diǎn)擊進(jìn)入?yún)R總目錄」
#測(cè)試驗(yàn)證
第一步:?jiǎn)?dòng)Spring Boot應(yīng)用,訪問(wèn)http://localhost:8080
,可以看到如下的文件上傳頁(yè)面。
第二步:選擇一個(gè)不大于2MB的文件,點(diǎn)擊“提交”按鈕,完成上傳。
如果上傳成功,將顯示類似下面的頁(yè)面:
你可以根據(jù)打印的文件路徑去查看文件是否真的上傳了。
#代碼示例
本文的相關(guān)例子可以查看下面?zhèn)}庫(kù)中的chapter4-3
目錄: