Spring Boot 對文件上傳做了簡化,基本做到了零配置,我們只需要在項目中添加 spring-boot-starter-web 依賴即可。
一、單文件上傳
1,代碼編寫
(1)首先
在 static 目錄中創建一個 upload.html 文件,內容如下:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <form action="/upload" method="post" enctype="multipart/form-data"> <input type="file" name="uploadFile" value="請選擇文件"> <input type="submit" value="上傳"> </form> </body> </html>
(2)接着創建文件上傳處理接口 FileUploadController.java,內容如下:
import org.springframework.ui.Model; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.multipart.MultipartFile; import javax.servlet.http.HttpServletRequest; import java.io.File; import java.io.IOException; import java.text.SimpleDateFormat; import java.util.Date; import java.util.UUID; @RestController public class FileUploadController { SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd/"); @PostMapping("/upload") public String upload(MultipartFile uploadFile, HttpServletRequest req) { // 上傳的文件將保存在項目運行目錄下的 uploadFile 文件夾, String realPath = req.getSession().getServletContext().getRealPath("/uploadFile/"); System.out.println(realPath); // 並且在 uploadFile 文件夾中通過日期對上傳的文件歸類保存 String format = sdf.format(new Date()); File folder = new File(realPath + format); if (!folder.isDirectory()) { folder.mkdirs(); } // 對上傳的文件重命名,避免文件重名 String oldName = uploadFile.getOriginalFilename(); String newName = UUID.randomUUID().toString() + oldName.substring(oldName.lastIndexOf("."), oldName.length()); try { // 文件保存 uploadFile.transferTo(new File(folder, newName)); // 返回上傳文件的訪問路徑 String filePath = req.getScheme() + "://" + req.getServerName() + ":" + req.getServerPort() + "/uploadFile/" + format + newName; return filePath; } catch (IOException e) { e.printStackTrace(); } return "上傳失敗!"; } }
2,運行測試
(1)我們使用瀏覽器訪問 upload.html 頁面並選擇文件上傳:
(2)上傳成功后會返回上傳文件的訪問路徑:

(3)使用這個訪問路徑我們就可以看到剛剛上傳的文件:
附:常用參數配置
(1)如果我們需要對圖片上傳的細節進行配置,也是可以的。比如我們可以在 application.properties 文件中添加如下配置:
spring.servlet.multipart.enabled=true
spring.servlet.multipart.file-size-threshold=0
spring.servlet.multipart.location=D:\\workspace
spring.servlet.multipart.max-file-size=1MB
spring.servlet.multipart.max-request-size=10MB
spring.servlet.multipart.resolve-lazily=false
yml版本
spring:
servlet:
multipart:
enabled:true
file-size-threshold:''
location:D:\\workspace
max-file-size:1MB
max-request-size:10MB
resolve-lazily:false
(2)上面幾個參數作用如下:
- spring.servlet.multipart.enabled:表示是否開啟文件上傳支持,默認為 true
- spring.servlet.multipart.file-size-threshold:表示文件寫入磁盤的閥值,默認為 0
- spring.servlet.multipart.location:表示上傳文件的臨時保存位置
- spring.servlet.multipart.max-file-size:表示上傳的單個文件的最大大小,默認為 1MB
- spring.servlet.multipart.max-request-size:表示多文件上傳時文件的總大小,默認為 10MB
- spring.servlet.multipart.resolve-lazily:表示文件是否延遲解析,默認為 false