SpringBoot文件上傳的基礎配置
要在SpringBoot中實現文件上傳功能，首先需要完成一些基礎配置工作。我們需要在application.properties或application.yml文件中配置上傳文件的存儲路徑，并設置上傳文件的最大大小。代碼如下所示：
spring.servlet.multipart.enabled=true spring.servlet.multipart.file-size-threshold=2KB spring.servlet.multipart.max-file-size=200MB spring.servlet.multipart.max-request-size=215MB spring.mvc.static-path-pattern=/upload/**
其中，"spring.servlet.multipart.enabled"參數用于啟用文件上傳功能。"spring.servlet.multipart.file-size-threshold"參數設置了文件在磁盤上的臨界值，低于該值的文件將直接存儲在內存中。"spring.servlet.multipart.max-file-size"和"spring.servlet.multipart.max-request-size"參數則分別限制了單個文件的最大尺寸和整個請求的最大尺寸。最后，"spring.mvc.static-path-pattern"參數用于指定靜態(tài)資源的訪問路徑，這樣我們就可以通過該路徑訪問上傳的文件。
構建文件上傳控制器
有了基礎配置后，我們就可以開始編寫文件上傳的控制器代碼了。控制器主要負責處理前端頁面發(fā)送的文件上傳請求，并將文件存儲在服務器上。以下是一個簡單的文件上傳控制器示例：
@Controller
public class FileUploadController {
@Value("${upload.path}")
private String uploadPath;
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file, Model model) {
if (!file.isEmpty()) {
try {
String filename = file.getOriginalFilename();
file.transferTo(new File(uploadPath + filename));
model.addAttribute("message", "文件上傳成功!");
} catch (IOException e) {
model.addAttribute("message", "文件上傳失敗: " + e.getMessage());
e.printStackTrace();
}
} else {
model.addAttribute("message", "請選擇要上傳的文件!");
}
return "upload";
}
}在這個控制器中，我們使用"@Value"注解獲取了"application.properties"中配置的"upload.path"屬性，該屬性指定了文件上傳的存儲路徑。"handleFileUpload"方法處理了前端發(fā)送的文件上傳請求，并將文件保存到服務器上。如果上傳成功，則返回一個"文件上傳成功"的提示消息；否則返回相應的錯誤消息。
前端頁面的設計
有了后端的控制器代碼，我們還需要設計一個前端頁面來接收用戶的文件上傳操作。以下是一個簡單的文件上傳頁面示例：
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>文件上傳</title>
</head>
<body>文件上傳
<form th:action="@{/upload}" method="post" enctype="multipart/form-data">
<input type="file" name="file" />
<button type="submit">上傳</button>
</form>
<p th:text="${message}">
</body>
</html>這個頁面使用了Thymeleaf模板引擎，包含一個簡單的文件上傳表單。表單的"action"屬性指向了我們之前編寫的控制器方法"/upload"，"enctype"屬性設置為"multipart/form-data"，以支持文件上傳。表單中包含一個文件選擇控件和一個提交按鈕。頁面下方還顯示了后端返回的提示消息。
文件上傳的安全性考慮
在實現文件上傳功能時，我們還需要考慮一些安全性問題。首先，我們應該限制允許上傳的文件類型，防止用戶上傳惡意文件?？梢酝ㄟ^在控制器中檢查文件的MIME類型來實現。其次，我們應該對上傳的文件進行校驗和清理，以防止用戶上傳含有惡意代碼的文件。此外，我們還需要對上傳路徑進行嚴格的權限控制，確保只有授權用戶才能訪問上傳的文件。
文件上傳進度條的實現
為了提升用戶體驗，我們可以在文件上傳過程中顯示進度條。實現進度條的關鍵是在服務端捕獲文件上傳事件，并將上傳進度實時推送給前端?？梢允褂肳ebSocket或者Servlet 3.0中引入的異步處理機制來實現這一功能。以下是一個簡單的示例：
@Controller
public class FileUploadController {
@GetMapping("/upload")
public String showUploadPage(Model model) {
model.addAttribute("uploadProgress", 0);
return "upload";
}
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file, Model model) {
// 文件上傳邏輯...
model.addAttribute("uploadProgress", 100);
return "upload";
}
@GetMapping("/upload/progress")
@ResponseBody
public int getUploadProgress() {
// 實時計算上傳進度,并返回給前端
return 50;
}
}在這個示例中，我們添加了一個"/upload/progress"接口，用于實時返回文件上傳的進度。前端頁面可以通過定期調用這個接口來獲取最新的進度信息，并更新進度條的顯示。這種方式雖然簡單，但存在一些局限性，比如需要頻繁輪詢服務端，影響用戶體驗。在實際項目中，我們可以考慮使用WebSocket或者Servlet 3.0異步處理機制來實現更加實時和高效的進度條顯示。
