- +在此添加单个AI新笔记
文件上传 - 多文件上传 - 支持多个文件上传
Java - Web - Spring 《文件上传 - 多文件上传 - 支持多个文件上传》
在 Web 开发中，文件上传是一个非常常见的需求。例如，在一个图片分享网站中，用户可能需要一次性上传多张图片；在一个文档管理系统中，用户也可能需要批量上传多个文档。Spring 框架为我们提供了便捷的方式来实现多文件上传功能，本文将详细介绍如何在 Spring 项目中实现多文件上传。
1. 项目环境搭建
首先，我们需要创建一个 Spring Boot 项目。可以使用 Spring Initializr（https://start.spring.io/）来快速生成项目骨架，添加以下依赖：
- Spring Web
- Spring Boot DevTools（可选，用于开发时热部署）
2. 配置文件上传
在 application.properties 或 application.yml 中添加文件上传相关的配置，例如：
# 设置单个文件最大上传大小spring.servlet.multipart.max-file-size=10MB# 设置一次请求中所有文件的最大上传大小spring.servlet.multipart.max-request-size=100MB
3. 创建 HTML 表单
创建一个简单的 HTML 表单，用于选择并上传多个文件。在 src/main/resources/static 目录下创建 upload.html 文件，代码如下：
<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>多文件上传</title></head><body><form action="/upload" method="post" enctype="multipart/form-data"><input type="file" name="files" multiple><input type="submit" value="上传"></form></body></html>
这里的 multiple 属性允许用户选择多个文件进行上传，表单的 action 属性指定了处理上传请求的 URL。
4. 创建控制器
创建一个 Spring 控制器来处理文件上传请求。在 src/main/java 目录下创建控制器类，代码如下：
import org.springframework.stereotype.Controller;import org.springframework.web.bind.annotation.PostMapping;import org.springframework.web.bind.annotation.RequestParam;import org.springframework.web.multipart.MultipartFile;import java.io.File;import java.io.IOException;import java.util.List;@Controllerpublic class FileUploadController {@PostMapping("/upload")public String handleFileUpload(@RequestParam("files") List<MultipartFile> files) {if (files!= null &&!files.isEmpty()) {for (MultipartFile file : files) {if (!file.isEmpty()) {try {// 获取文件的原始文件名String fileName = file.getOriginalFilename();// 指定文件保存的路径String filePath = "uploads/" + fileName;// 创建保存文件的目录File dest = new File(filePath);if (!dest.getParentFile().exists()) {dest.getParentFile().mkdirs();}// 将文件保存到指定路径file.transferTo(dest);} catch (IOException e) {e.printStackTrace();return "上传失败";}}}return "上传成功";}return "没有选择文件";}}
在这个控制器中，我们使用 @RequestParam("files") 注解来接收表单中名为 files 的多个文件，类型为 List<MultipartFile>。然后遍历这个列表，将每个文件保存到指定的目录中。
5. 运行项目
启动 Spring Boot 项目，访问 http://localhost:8080/upload.html，选择多个文件并点击上传按钮，即可完成多文件上传。
6. 总结
| 步骤 | 描述 |
|---|---|
| 1. 项目环境搭建 | 使用 Spring Initializr 创建 Spring Boot 项目，添加必要的依赖 |
| 2. 配置文件上传 | 在配置文件中设置文件上传的最大大小 |
| 3. 创建 HTML 表单 | 使用 multiple 属性允许用户选择多个文件，指定表单的 action 和 enctype |
| 4. 创建控制器 | 使用 @RequestParam 注解接收多个文件，遍历文件列表并保存到指定目录 |
| 5. 运行项目 | 启动项目，访问表单页面进行文件上传 |
通过以上步骤，我们就可以在 Spring 项目中实现多文件上传功能。在实际开发中，还可以根据需求对文件进行进一步的处理，例如文件类型验证、文件重命名等。希望本文对你有所帮助！