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 中请求体数据绑定和文件上传的核心技术。建议结合代码示例进行实际操作练习。