@RequestParam文件上传

### Spring @RequestParam 文件上传示例及用法 在 Spring MVC 中，`@RequestParam` 注解不仅可以用于接收简单的字符串或数值类型的参数，还可以用来处理文件上传操作。为了实现这一功能，通常会结合 `MultipartFile` 类型来完成。 以下是关于如何使用 `@RequestParam` 进行文件上传的具体说明： #### 1. 配置支持文件上传的环境 要启用文件上传功能，需确保项目中已引入必要的依赖项以及配置好 multipart 支持。例如，在 Maven 的 `pom.xml` 文件中添加以下依赖[^4]： ```xml <dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency> ``` 同时，在 Spring Boot 应用程序中，默认情况下已经启用了 Multipart 功能，但如果需要自定义最大文件大小或其他设置，可以在 `application.properties` 或 `application.yml` 文件中进行如下配置: ```properties spring.servlet.multipart.max-file-size=10MB spring.servlet.multipart.max-request-size=10MB ``` #### 2. 控制器方法中的实现 下面是一个基于 `@RequestParam` 和 `MultipartFile` 实现文件上传的例子： ```java import org.springframework.web.bind.annotation.*; import org.springframework.web.multipart.MultipartFile; import java.io.IOException; @RestController @RequestMapping("/file") public class FileUploadController { @PostMapping("/upload") public String handleFileUpload(@RequestParam("file") MultipartFile file) { if (file.isEmpty()) { return "Please select a file to upload."; } try { byte[] bytes = file.getBytes(); // 处理文件逻辑（如保存到磁盘） System.out.println("Uploaded file name: " + file.getOriginalFilename()); return "You successfully uploaded '" + file.getOriginalFilename() + "'"; } catch (IOException e) { return "Failed to upload the file due to an error: " + e.getMessage(); } } } ``` 上述代码片段展示了如何通过 POST 请求将单个文件上传至服务器端，并将其存储为字节数组以便进一步处理[^3]。 #### 3. 测试接口 可以通过 Postman 工具或者 HTML 表单测试该 API 接口。对于表单提交方式，请注意 enctype 属性应设为 `"multipart/form-data"`[^2]: ```html <form action="http://localhost:8080/file/upload" method="POST" enctype="multipart/form-data"> Select file to upload: <input type="file" name="file"/> <button type="submit">Upload</button> </form> ``` 当用户点击按钮后，浏览器会发送一个包含选定文件的数据包给指定 URL 地址下的服务端点 `/file/upload`。 --- ### 注意事项 - 如果希望允许多个文件同时上传，则可以修改控制器签名并接受列表形式输入： ```java @PostMapping("/uploads") public String handleMultipleFilesUpload(@RequestParam("files") List<MultipartFile> files){ ... } ``` - 对于大型文件传输场景下可能遇到性能瓶颈问题时，考虑采用流式读取机制代替一次性加载整个文件入内存的方式[^1]. ---