通俗易懂搞懂@RequestParam 和 @RequestBody

碎碎念

作为一名学习spring框架的小白来说,项目实战无疑是学习成长速度最快的阶段之一。但这也不免会遇到很多折磨人的知识点让人防不胜防。比如参数绑定相关注解的使用:

  • @Param
  • @RequestParam
  • @RequestBody

用哪个?啥时候必须用?啥时候可以不用?把俺整的的一愣一愣的。

于是特意整理了这篇博客,目的是帮助大家快速理清这些注解的使用场景和区别,避开常见的坑点。


目录


前言

本博客将会详细讲解以下参数绑定相关注解的使用场景,说明它们之间的关系和区别,以及在项目开发中使用的规范

  • @RequestParam
  • @RequestBody
  • @@ModelAttribute

一、@RequestParam

@RequestParam专门用于获取请求URL中的参数,也就是问号?后面的参数。(HTML的form表单也适用)

例如下面的请求:

复制代码
GET /search?name=Tom&age=25

对应的Controller方法:

java 复制代码
@GetMapping("/search")
public String search(@RequestParam String name, @RequestParam Integer age) {
    return "搜索名字:" + name + ",年龄:" + age;
}

什么时候必须用@RequestParam?

  • 当方法参数名和请求参数名不一致时必须用

    java 复制代码
    @GetMapping("/search")
    public String search(@RequestParam("user_name") String name) {
        return name;
    }
  • 参数非必传时(可选)必须明确标注

    java 复制代码
    @GetMapping("/search")
    public String search(@RequestParam(required = false) String name) {
        return name;
    }

RequestParam(required = false)的意思是如果前端没有传递参数name,不会直接报错,而是赋值null。

什么时候可以不用@RequestParam?

  • 当方法参数名和请求URL参数名完全一致并且参数是必传时,可以省略:

    java 复制代码
    // URL: /search?name=Tom
    @GetMapping("/search")
    public String search(String name) {
        return name;
    }

二、@ModelAttribute

作用

@ModelAttribute`注解专门用于将请求参数(URL参数表单数据)绑定到一个Java对象中,尤其适合表单提交的场景或有多个参数需要绑定的情况。

例如请求:

复制代码
GET /user?name=Tom&age=20

对应的Controller方法:

java 复制代码
@GetMapping("/user")
public String getUser(@ModelAttribute User user) {
    return "姓名:" + user.getName() + ",年龄:" + user.getAge();
}

User类定义:

java 复制代码
public class User {
    private String name;
    private Integer age;

    // getter和setter方法必须提供
}

使用@ModelAttribute时的注意点:

  • 对象的属性名称必须与请求中的参数名称保持一致,这样才能正确绑定。
  • 如果有多个参数,并且这些参数是Java对象的,那么推荐使用这个注解(前端发送请求非JSON等格式的情况下)

三、@RequestBody

@RequestBody用于接收HTTP请求体(Request Body)中的数据,常用于POST请求,通常是JSON格式的数据。

例如POST请求:

复制代码
POST /user
Content-Type: application/json

{
  "name": "Alice",
  "age": 30
}

对应的Controller方法:

java 复制代码
@PostMapping("/user")
public String createUser(@RequestBody User user) {
    return "用户姓名:" + user.getName() + ",年龄:" + user.getAge();
}

User类定义:

java 复制代码
public class User {
    private String name;
    private Integer age;

    // getter和setter方法
}

什么时候必须用@RequestBody?

  • 前端发送JSON数据或XML数据等格式到后端时必须用
  • 当你需要整个请求体的数据绑定到一个Java对象时。

什么时候可以不用@RequestBody?

  • 当数据从URL参数(如GET请求)或表单数据中获取时,不需要也不能使用@RequestBody。
  • 对于表单提交,可以使用@ModelAttribute来代替:
java 复制代码
@PostMapping("/submit")
public String submitForm(@ModelAttribute User user) {
    return user.getName();
}

四、表格整理

场景 传参方式 适用注解 是否必须
单个或少量简单参数(如 ?name=Tom URL参数或表单提交 @RequestParam 推荐✅
多个参数形成对象(如 ?name=Tom&age=20 URL参数或表单提交 @ModelAttribute 推荐 ✅
JSON、XML数据 请求体(POST) @RequestBody 必须用

使用规范:

如果仍然觉得比较绕,最简单粗暴的方式就是全部都用上参数绑定。

因为不论参数是否一致,始终明确标注注解,可以提高代码可读性和可维护性。

相关推荐
天天摸鱼的java工程师1 分钟前
Spring事务什么时候会失效?常见业务场景详解与修复方案
java·后端·面试
打野二师兄27 分钟前
Spring Boot 自动配置:从 2.x 到 3.x 的进化之路
java·spring boot·后端
2zcode33 分钟前
基于Matlab图像处理的静态雨滴去除与质量评估系统
开发语言·图像处理·matlab
默默敲代码的徐哥儿39 分钟前
八股文整理——计算机网络
服务器·网络·计算机网络
胎粉仔1 小时前
Objective-c 初阶——异常处理(try-catch)
开发语言·ios·objective-c
Monkey-旭1 小时前
Android JNI 语法全解析:从基础到实战
android·java·c++·c·jni·native
小徐不徐说1 小时前
RTSP协议详解与C++实现实例
开发语言·c++·qt·通信·rtsp
魑魅魍魉都是鬼1 小时前
随缘玩 一: 代理模式
android·java·代理模式
流星白龙1 小时前
【C++算法】75.优先级队列_数据流中的第 K 大元素
开发语言·c++·算法
Monkey的自我迭代1 小时前
python线性回归:从原理到实战应用
开发语言·python·机器学习