Spring MVC 核心注解与文件上传教程

一、@RequestBody 注解详解

1. 基本使用

作用：从 HTTP 请求体中获取数据，适用于 POST/PUT 请求。
限制：GET 请求无请求体，不可使用该注解。

示例代码

@Controller
@RequestMapping("/demo01")
public class Demo01Controller {@PostMapping("/test1")public void test1(@RequestBody String requestBody, HttpServletResponse response) throws IOException {System.out.println("请求体内容：" + requestBody);response.getWriter().write(requestBody);}
}

前端测试方式

1. 表单提交（默认格式：application/x-www-form-urlencoded）

<form action="/demo01/test1" method="post"><input type="text" name="id"><input type="text" name="name"><input type="submit">
</form>

输出示例：id=2&name=zhangsan

2. AJAX JSON 提交

$("#btn").click(function() {const data = { id: 1, name: "吉林省" };$.post({url: "/demo01/test1",contentType: "application/json",data: JSON.stringify(data),success: function(res) { console.log(res); }});
});

输出示例：{"id":1,"name":"吉林省"}

---

2. JSON 数据绑定

要求：

• 请求头必须包含 Content-Type: application/json
• 需要 jackson-databind 依赖支持 JSON 转换

实体类与控制器

@Data // Lombok 注解，自动生成 getter/setter
public class Province {private Integer id;private String name;
}@RestController
@RequestMapping("/demo01")
public class Demo01Controller {@PostMapping("/test2")public Province test2(@RequestBody Province province) {System.out.println("接收对象：" + province);return province; // 自动转为 JSON 返回}
}

前端测试

$("#btn").click(function() {const province = { id: 2, name: "重庆" };$.post({url: "/demo01/test2",contentType: "application/json",data: JSON.stringify(province),success: function(res) { console.log(res); }});
});

输出结果：Province(id=2, name=重庆)

---

二、文件上传实战

1. 环境配置

依赖引入

<!-- 文件上传核心依赖 -->
<dependency><groupId>commons-fileupload</groupId><artifactId>commons-fileupload</artifactId><version>1.4</version>
</dependency>

Spring 配置文件

<!-- 配置 MultipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"><property name="maxUploadSize" value="10240000"/> <!-- 最大10MB --><property name="defaultEncoding" value="UTF-8"/>
</bean>

---

2. 单文件上传

前端表单

<form enctype="multipart/form-data" action="/demo01/upload" method="post"><input type="file" name="myfile"><input type="submit">
</form>

控制器实现

@PostMapping("/upload")
public void uploadFile(@RequestPart("myfile") MultipartFile file, HttpServletResponse response) throws IOException {// 获取文件信息String fileName = file.getOriginalFilename();long size = file.getSize();// 保存到磁盘file.transferTo(new File("D:/uploads/" + fileName));// 返回响应response.setContentType("text/html;charset=utf-8");response.getWriter().write("文件名：" + fileName + "<br>大小：" + size + "字节");
}

---

3. 多文件上传

前端表单

<form enctype="multipart/form-data" action="/demo01/uploads" method="post"><input type="file" name="myfiles" multiple><input type="file" name="myfiles"><input type="submit">
</form>

控制器实现

@PostMapping("/uploads")
public String uploadFiles(@RequestPart("myfiles") MultipartFile[] files) throws IOException {for (MultipartFile file : files) {if (!file.isEmpty()) {file.transferTo(new File("D:/uploads/" + file.getOriginalFilename()));}}return "上传成功！共处理 " + files.length + " 个文件";
}

---

三、注意事项

1. 文件上传限制
   • 表单必须设置 enctype="multipart/form-data"
   • 提交方式必须为 POST
2. 常见错误
   • 415 错误：未正确设置 Content-Type: application/json
   • 文件大小超限：检查 maxUploadSize 配置
3. 依赖问题
   • 确保 Lombok、Jackson、commons-fileupload 版本匹配

---

通过本教程，您已掌握 Spring MVC 中请求体数据绑定和文件上传的核心技术。建议结合代码示例进行实际操作练习。