# SpringBoot2.X使用文件處理器的示例分析
## 前言
在現代Web應用開發中，文件上傳、下載和管理是常見的功能需求。SpringBoot作為Java生態中最流行的框架之一，提供了簡潔高效的文件處理方案。本文將深入分析SpringBoot2.X中文件處理器的使用方式，通過完整示例演示文件上傳、下載、存儲等核心功能的實現。
## 一、SpringBoot文件處理基礎配置
### 1.1 添加必要依賴
```xml
<dependencies>
<!-- Web基礎支持 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Thymeleaf模板引擎（可選） -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
</dependencies>
在application.properties中配置上傳參數：
# 單個文件最大大小
spring.servlet.multipart.max-file-size=10MB
# 單次請求最大大小
spring.servlet.multipart.max-request-size=50MB
# 文件存儲路徑（自動創建）
file.upload-dir=./uploads
@Controller
public class FileUploadController {
@Value("${file.upload-dir}")
private String uploadDir;
@GetMapping("/upload")
public String showUploadForm() {
return "upload-form";
}
@PostMapping("/upload")
public String handleFileUpload(@RequestParam("file") MultipartFile file,
RedirectAttributes redirectAttributes) {
if (file.isEmpty()) {
redirectAttributes.addFlashAttribute("message", "請選擇文件");
return "redirect:/upload";
}
try {
// 創建存儲目錄
Path uploadPath = Paths.get(uploadDir);
if (!Files.exists(uploadPath)) {
Files.createDirectories(uploadPath);
}
// 保存文件
Path filePath = uploadPath.resolve(file.getOriginalFilename());
Files.copy(file.getInputStream(), filePath,
StandardCopyOption.REPLACE_EXISTING);
redirectAttributes.addFlashAttribute("message",
"文件上傳成功: " + file.getOriginalFilename());
} catch (IOException e) {
redirectAttributes.addFlashAttribute("message", "上傳失敗");
e.printStackTrace();
}
return "redirect:/upload";
}
}
<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
<title>文件上傳</title>
</head>
<body>
<h1>SpringBoot文件上傳示例</h1>
<div th:if="${message}">
<h2 th:text="${message}"></h2>
</div>
<form method="POST" enctype="multipart/form-data" action="/upload">
<input type="file" name="file" />
<button type="submit">上傳</button>
</form>
</body>
</html>
@GetMapping("/download/{filename:.+}")
public ResponseEntity<Resource> downloadFile(@PathVariable String filename) {
try {
Path filePath = Paths.get(uploadDir).resolve(filename).normalize();
Resource resource = new UrlResource(filePath.toUri());
if (resource.exists()) {
return ResponseEntity.ok()
.header(HttpHeaders.CONTENT_DISPOSITION,
"attachment; filename=\"" + resource.getFilename() + "\"")
.body(resource);
} else {
return ResponseEntity.notFound().build();
}
} catch (Exception e) {
return ResponseEntity.internalServerError().build();
}
}
@GetMapping("/files")
public String listFiles(Model model) {
File uploadDirectory = new File(uploadDir);
File[] files = uploadDirectory.listFiles();
model.addAttribute("files",
files != null ? Arrays.stream(files)
.map(File::getName)
.collect(Collectors.toList())
: Collections.emptyList());
return "file-list";
}
@PostMapping("/multi-upload")
public String handleMultipleUpload(@RequestParam("files") MultipartFile[] files,
RedirectAttributes redirectAttributes) {
Arrays.stream(files).forEach(file -> {
try {
Path filePath = Paths.get(uploadDir)
.resolve(file.getOriginalFilename());
Files.copy(file.getInputStream(), filePath);
} catch (IOException e) {
throw new RuntimeException("文件保存失敗", e);
}
});
redirectAttributes.addFlashAttribute("message",
files.length + "個文件上傳成功");
return "redirect:/upload";
}
@ControllerAdvice
public class FileUploadExceptionAdvice {
@ExceptionHandler(MaxUploadSizeExceededException.class)
public ResponseEntity<String> handleMaxSizeException() {
return ResponseEntity.badRequest()
.body("文件大小超過限制");
}
}
private static final List<String> ALLOWED_TYPES =
Arrays.asList("image/jpeg", "image/png", "application/pdf");
@PostMapping("/safe-upload")
public String safeUpload(@RequestParam("file") MultipartFile file,
RedirectAttributes redirectAttributes) {
if (!ALLOWED_TYPES.contains(file.getContentType())) {
redirectAttributes.addFlashAttribute("message", "不支持的文件類型");
return "redirect:/upload";
}
// 繼續處理上傳...
}
文件名處理：應過濾特殊字符防止路徑遍歷攻擊
String safeFilename = file.getOriginalFilename()
.replaceAll("[^a-zA-Z0-9.-]", "_");
存儲位置：不應使用Web可訪問目錄直接存儲上傳文件
病毒掃描：重要系統應集成病毒掃描功能
權限控制：敏感文件應設置適當的訪問權限
本文詳細介紹了SpringBoot2.X中文件處理的全流程實現，涵蓋了從基礎上傳下載到安全防護的各個方面。實際項目中可根據需求組合使用這些技術點，構建安全高效的文件管理系統。SpringBoot的簡潔設計使得文件處理變得異常簡單，但開發者仍需關注安全性和性能等關鍵因素。
提示：完整示例代碼可在GitHub倉庫獲?。僭O的示例鏈接） “`
注：本文實際約1600字，可根據需要增減內容。Markdown格式便于直接發布到技術博客平臺，代碼塊和章節結構清晰，適合技術文檔閱讀。
免責聲明：本站發布的內容（圖片、視頻和文字）以原創、轉載和分享為主，文章觀點不代表本網站立場，如果涉及侵權請聯系站長郵箱：is@yisu.com進行舉報，并提供相關證據，一經查實，將立刻刪除涉嫌侵權內容。
