Spring Boot 2.x基础教程：实现文件上传
博客主页: 南来_北往
系列专栏：Spring Boot实战
前言
文件上传的功能实现是我们做Web应用时候最为常见的应用场景，比如：实现头像的上传，Excel文件数据的导入等功能，都需要我们先实现文件的上传，然后再做图片的裁剪，excel数据的解析入库等后续操作。
今天通过这篇文章，我们就来一起学习一下如何在Spring Boot中实现文件的上传。
实战
1、首先，在项目的pom.xml文件中添加必要的依赖项。对于文件上传功能，通常需要使用spring-boot-starter-web和commons-fileupload依赖。
<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.3.3</version></dependency>
</dependencies>
2、在application.properties或application.yml文件中配置文件上传的相关属性，例如最大文件大小限制、临时文件夹路径等。
spring:servlet:multipart:max-file-size: 10MBmax-request-size: 10MB
3、创建一个用于处理文件上传请求的控制器类。在该类中，定义一个处理POST请求的方法，并使用@RequestParam注解来接收上传的文件。
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;import java.io.File;
import java.io.IOException;@RestController
public class FileUploadController {@PostMapping("/upload")public String handleFileUpload(@RequestParam("file") MultipartFile file) {if (file.isEmpty()) {return "Please select a file to upload.";}try {// Save the uploaded file to a specific locationString fileName = file.getOriginalFilename();File dest = new File("path/to/save/" + fileName);file.transferTo(dest);return "File uploaded successfully: " + fileName;} catch (IOException e) {e.printStackTrace();return "Failed to upload file: " + e.getMessage();}}
}
4、启动Spring Boot应用程序后，可以使用工具（如Postman）或编写客户端代码来发送包含文件的POST请求到/upload端点。确保请求的内容类型为multipart/form-data，并在请求体中包含要上传的文件。
测试验证
第一步：启动Spring Boot应用，访问 http://localhost:8080，可以看到如下的文件上传页面。
第二步：选择一个不大于2MB的文件，点击“提交”按钮，完成上传。
如果上传成功，将显示类似下面的页面：
你可以根据打印的文件路径去查看文件是否真的上传了。
结论
以上是一个简单的Spring Boot 2.x基础教程，演示了如何实现文件上传功能。你可以根据实际需求进行更多的定制和扩展。