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

一、@RequestBody 注解详解
1. 基本使用

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

示例代码
java 复制代码
@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
html 复制代码
<form action="/demo01/test1" method="post">
  <input type="text" name="id">
  <input type="text" name="name">
  <input type="submit">
</form>

输出示例id=2&name=zhangsan

  1. AJAX JSON 提交
javascript 复制代码
$("#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 转换
实体类与控制器
java 复制代码
@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 返回
    }
}
前端测试
javascript 复制代码
$("#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. 环境配置
依赖引入
xml 复制代码
<!-- 文件上传核心依赖 -->
<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>
Spring 配置文件
xml 复制代码
<!-- 配置 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. 单文件上传
前端表单
html 复制代码
<form enctype="multipart/form-data" action="/demo01/upload" method="post">
  <input type="file" name="myfile">
  <input type="submit">
</form>
控制器实现
java 复制代码
@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. 多文件上传
前端表单
html 复制代码
<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>
控制器实现
java 复制代码
@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 中请求体数据绑定和文件上传的核心技术。建议结合代码示例进行实际操作练习。

相关推荐
笑衬人心。4 分钟前
JVM 笔记:类加载、内存管理、垃圾收集与垃圾收集器
java·jvm·笔记
程序猿小D7 分钟前
Java项目:基于SSM框架实现的进销存管理系统【ssm+B/S架构+源码+数据库+毕业论文+远程部署】
java·数据库·mysql·ssm·jsp·毕业论文·进销存管理系统
得物技术12 分钟前
Java volatile 关键字到底是什么|得物技术
java·后端
HoHeHa15 分钟前
IDEA 手动下载安装数据库驱动,IDEA无法下载数据库驱动问题解决方案,IDEA无法连接数据库解决方案(通用,Oracle为例)
java·数据库·intellij-idea
你可以叫我仔哥呀20 分钟前
Java程序员学从0学AI(七)
java·开发语言·人工智能·ai·spring ai
杨DaB39 分钟前
【SpringMVC】MVC中Controller的配置 、RestFul的使用、页面重定向和转发
java·笔记·后端·学习·spring·mvc·restful
linyb极客之路42 分钟前
干货来袭!5 分钟学会快速实现责任链,效率直接拉满!
java
创码小奇客1 小时前
保姆级 Talos 超参数优化实战指南:从入门到封神
java·后端·架构
青云交1 小时前
Java 大视界 -- Java 大数据在智能安防入侵检测系统中的多源数据融合与误报率降低策略(369)
java·大数据·入侵检测·智能安防·多源数据融合·误报率降低·视频语义理解
我会冲击波1 小时前
告别手写注释!变量命名、注释IDEA插件更新了,AI帮你搞定一切代码注释
java·intellij idea