SpringBoot单文件与多文件上传实现详解

"这篇教程详细讲解了如何在SpringBoot应用中实现单文件和多文件的上传功能，提供了具体的代码示例。" 在SpringBoot中，文件上传是常见的数据交互需求，通常涉及到MultipartFile接口和相关配置。本教程将介绍如何在SpringBoot中实现单个文件和多个文件的上传。 首先，为了支持文件上传，我们需要在SpringBoot的配置文件（application.properties或application.yml）中添加以下配置，允许Multipart请求： ```properties # application.properties multipart.max-file-size=10MB multipart.max-request-size=10MB ``` 这将设置单个文件的最大大小为10MB，整个请求的最大大小也为10MB。你可以根据实际需求调整这些值。 接下来，我们创建一个控制器类，例如`UploadController`，并在其中定义处理文件上传的端点。在给定的代码中，这个类包含了一个`@PostMapping("/upload")`方法，用于处理单文件上传。该方法接收一个`@RequestParam("file", required = false)`注解的`MultipartFile`参数，表示上传的文件。`HttpServletRequest request`参数则用于获取额外的信息，如果需要的话。 代码中的`CommonUtil.hasAllRequired()`方法用于验证JSON对象中是否存在必需的字段，这是对客户端提交的数据进行校验的一种方式，确保数据的完整性和安全性。 然后，我们创建一个`BufferedOutputStream`对象来处理文件写入操作。在实际的文件保存逻辑中，你需要根据业务需求创建一个目录（例如`uploadPath`），并使用`MultipartFile.transferTo()`方法将上传的文件保存到指定位置。这是一个典型的文件保存示例： ```java // 创建目标文件路径 String fileName = file.getOriginalFilename(); File targetFile = new File(uploadPath, fileName); // 将上传的文件保存到目标路径 if (!targetFile.exists()) { targetFile.getParentFile().mkdirs(); // 创建父目录 } file.transferTo(targetFile); ``` 对于多文件上传，你可以使用`MultipartHttpServletRequest`来获取所有的文件。`MultipartHttpServletRequest`是Spring MVC提供的一个接口，它扩展了`HttpServletRequest`，并且提供了获取所有文件的便捷方法： ```java @PostMapping("/uploads") public JSONObject uploadFiles(@RequestParam MultipartHttpServletRequest request) throws Exception { JSONObject returnData = new JSONObject(); Map<String, MultipartFile> files = request.getFileMap(); for (Map.Entry<String, MultipartFile> entry : files.entrySet()) { MultipartFile file = entry.getValue(); // 保存文件的逻辑，类似于单文件上传 } } ``` 在这个例子中，`files`是一个映射，键是表单字段名，值是对应的`MultipartFile`对象。你可以遍历这个映射，对每个文件执行相同的保存逻辑。 在整个过程中，需要注意异常处理，如文件过大、文件类型不合法、磁盘空间不足等可能导致的问题，需要进行适当的错误处理并反馈给客户端。 SpringBoot通过集成Spring MVC，提供了一套简洁的文件上传解决方案。通过`MultipartFile`接口和`MultipartHttpServletRequest`类，我们可以方便地处理单个或多个文件的上传操作，并在服务器端进行存储和管理。同时，别忘了对上传过程进行安全检查，确保数据的正确性和系统的稳定性。