当前位置：首页 > news >正文

升级 Spring Boot 3 配置讲解 —— 如何处理文件上传下载？

news 来源：原创 2025/5/13 16:41:10

学会这款 🔥全新设计的 Java 脚手架，从此面试不再怕！

1. 环境准备

在开始之前，确保你已经具备以下环境：

JDK 17 或更高版本（Spring Boot 3 要求的最低 JDK 版本）
Maven 或 Gradle 构建工具
Spring Boot 3.x

你可以在 pom.xml 中添加以下依赖来引入 Spring Boot 3：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-thymeleaf</artifactId></dependency>
</dependencies>

2. 文件上传

2.1 配置文件上传限制

在 Spring Boot 3 中，文件上传的默认配置已经足够应对大多数场景，但你仍然可以通过 application.properties 或 application.yml 文件进行自定义配置。例如：

# 设置单个文件的最大大小
spring.servlet.multipart.max-file-size=10MB# 设置总上传文件的最大大小
spring.servlet.multipart.max-request-size=50MB

2.2 实现文件上传接口

接下来，我们来实现一个简单的文件上传接口。首先，创建一个 FileUploadController 类：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.multipart.MultipartFile;
import org.springframework.web.servlet.mvc.support.RedirectAttributes;import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;@Controller
public class FileUploadController {// 上传文件保存的目录private static String UPLOAD_DIR = "uploads/";@GetMapping("/upload")public String uploadPage() {return "upload";}@PostMapping("/upload")public String handleFileUpload(@RequestParam("file") MultipartFile file, RedirectAttributes redirectAttributes) {if (file.isEmpty()) {redirectAttributes.addFlashAttribute("message", "请选择一个文件上传");return "redirect:/upload";}try {// 保存文件到指定目录byte[] bytes = file.getBytes();Path path = Paths.get(UPLOAD_DIR + file.getOriginalFilename());Files.write(path, bytes);redirectAttributes.addFlashAttribute("message", "文件上传成功: " + file.getOriginalFilename());} catch (IOException e) {e.printStackTrace();redirectAttributes.addFlashAttribute("message", "文件上传失败: " + file.getOriginalFilename());}return "redirect:/upload";}
}

2.3 创建上传页面

为了测试文件上传功能，我们可以创建一个简单的 HTML 页面。在 src/main/resources/templates 目录下创建 upload.html 文件：

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head><title>文件上传</title>
</head>
<body><h1>文件上传</h1><form method="POST" action="/upload" enctype="multipart/form-data"><input type="file" name="file" /><button type="submit">上传</button></form><p th:text="${message}"></p>
</body>
</html>

2.4 运行并测试

启动应用程序后，访问 http://localhost:8080/upload，你将看到一个简单的文件上传界面。选择一个文件并点击上传，文件将被保存到 uploads/ 目录中。

3. 文件下载

3.1 实现文件下载接口

文件下载的实现同样简单。我们可以在 FileUploadController 中添加一个下载接口：

import org.springframework.core.io.Resource;
import org.springframework.core.io.UrlResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;import java.net.MalformedURLException;
import java.nio.file.Path;
import java.nio.file.Paths;@Controller
public class FileUploadController {// 省略之前的代码...@GetMapping("/download/{filename:.+}")public ResponseEntity<Resource> downloadFile(@PathVariable String filename) {try {Path path = Paths.get(UPLOAD_DIR + filename);Resource resource = new UrlResource(path.toUri());if (resource.exists() || resource.isReadable()) {return ResponseEntity.ok().header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"").body(resource);} else {throw new RuntimeException("文件不存在或不可读");}} catch (MalformedURLException e) {throw new RuntimeException("文件下载失败", e);}}
}

3.2 测试文件下载

启动应用程序后，访问 http://localhost:8080/download/文件名，你将能够下载指定的文件。例如，如果你上传了一个名为 example.txt 的文件，可以通过 http://localhost:8080/download/example.txt 进行下载。

4. 总结

通过本文的介绍，你已经学会了如何在 Spring Boot 3 中处理文件上传和下载。Spring Boot 3 提供了更加简洁和强大的 API，使得文件操作变得更加容易。希望本文的内容能够帮助你在实际项目中更好地处理文件上传和下载的需求。

如果你有任何问题或建议，欢迎在评论区留言讨论。Happy coding!

学会这款 🔥全新设计的 Java 脚手架 ，从此面试不再怕！