@RequestParam,@RequestBody,@ResponseBody,@PathVariable注解的一点小总结

一、前提知识:

  1. http协议规定一次请求对应一次响应,根据不同的请求方式,请求的内容会有所不同;
  2. 发送GET请求是没有请求体的,参数会直接拼接保留到url后一并发送;
  3. 而POST请求是带有请求体的,带着请求体一并发送,每次请求请求体只会有一个;

二、注解介绍

@RequestParam注解:将返回到后端的请求参数绑定到控制器方法参数,该注解有两个需要了解的属性

  1. 一个是required属性,默认是true 当该属性为true的时候,且指定了value属性时,如果前台页面的key跟接收的value不同是是会报400错误的; 而当该属性为false的是会,即使key不存在,也不会报400的错; ⚠️但是当后面的参数的基本数据类型的时候,是会报500错误的,因为当找不到值的时候,会默认返回一个null,基本数据类型接收到null,直接就会报错,解决方法就是使用对应的引用类型去接收,即使时null也不会报错
  2. 另一个是defaultValue属性,默认值是16个Unicode字符 使用了该属性之后,且指定了value属性,但是前端页面并没有给对应的key时,就会默认采用这个自动值,底层会帮我们自动转换成参数类型

⚠️绑定的方法参数是附加到url后的[key-value]格式的值,进而衍生出也可以是数组、对象或者集合,接下来会进行演示

@RequestBody跟@ResponseBody:这两个注解的作用其实是一样的,处理的都是json字符串,只不过前一个注解是从前往后传,第二个注解是从后往前传,接下来也会样式这两个注解的使用方式

⚠️所以讲到这里其实应该明白,@RequestBody注解在一个方法中只会出现一次,而@RequestParam则可以出现多个,这是因为@RequestBody接收的是整个请求体的json格式化字符串,而@RequestParam接收的是附加到url后面的[key-value]形式值,会存在多个这样的值,所以自然也可以使用多个@RequestParam注解来接收,如果是较少的参数那还好,如果太多的参数,一个一个获取就太麻烦了,而且写出来的代码也不够优雅整洁。

@PathVariable的作用其实就是接收url后面传过来的变量,这个注解使用起来很简单

三、注解的简单演示

是基于springboot环境,使用postman来测试

一、@RequestParam注解

  1. 简单使用,接收url后面的 key-value值
//测试的接口 : localhost:8080/testRequestParam/one?name=Amg&age=22
​
@RestController
@RequestMapping("/testRequestParam")
public class TestRequestParamAnno {
​
    @GetMapping("/one")
    public Result one(@RequestParam(value = "name") String name,
                      @RequestParam(value = "age") int age){

        System.out.println(name + " / " + age);
        return ResultGenerator.getSuccessful(name + " / " + age);
    }
​
}
​
//output ResultGenerator返回的是一个对象,通过@ResponseBody转换成json字符串格式
{
    "code": 200,
    "msg": "Amg / 22"
}

undefined

2.测试添加required属性跟defaultValue属性

//测试的接口: localhost:8080/testRequestParam/two?name=Amg&=
​
@GetMapping("/two")
public Result two(@RequestParam(value = "name") String name,
                  @RequestParam(value = "age") int age) {
​
    System.out.println(name + " / " + age);
    return ResultGenerator.getSuccessful(name + " / " + age);
}
​
//output 这是由于返回的url中没有 age 这个key,所以报400错误,这是很常见的一种错误
{
    "timestamp": "2020-09-26T07:22:51.449+00:00",
    "status": 400,
    "error": "Bad Request",
    "trace": "org.springframework.web.bind.MissingServletRequestParameterException: Required int parameter 'age' is not present
    "message": "Required int parameter 'age' is not present",
    "path": "/testRequestParam/two"
}
​
//此时可以通过给默认值来解决
@GetMapping("/two")
public Result two(@RequestParam(value = "name") String name,
                  @RequestParam(value = "age" ,defaultValue = "1") int age) {
​
    System.out.println(name + " / " + age);
    return ResultGenerator.getSuccessful(name + " / " + age);
}
​
//output
{
    "code": 200,
    "msg": "Amg / 1"
}

undefined

3.如果url后有多个key值,那么如此一个一个的接收就会显得很麻烦,而且方法参数也会很膨胀,一点都不优雅,其实我们还可以这样操作

//这种写法就会使得方法参数很膨胀(不建议使用),其实我们只需要改造一下
public Result three(@RequestParam(value = "name") String name,
                    @RequestParam(value = "age") int age,
                    @RequestParam(value = "gender") String gender,
                    @RequestParam(value = "lover") String lover,
                    @RequestParam(value = "weight") double weight ){
​
}
​
//用一个Map来接收所有的key,value值
@GetMapping("three")
public Result three(@RequestParam Map map){
​
    StringBuilder sb = new StringBuilder();
    map.forEach((key,value) -> {
        sb.append(key + " / " + value + "; ");
    });
    return ResultGenerator.getSuccessful(sb.toString());
}
​
//output
{
    "code": 200,
    "msg": "name / Amg; age / 22; gender / 男; lover / guess; weight / guess; "
}

undefined

二、@Requestbody和@ResponseBody

//首先构造一个对象,使用lombok插件给getter/setter和tostring方法
​
@Data
@ToString
public class User {

    private String name;

    private Integer age;

    private String gender;
}

undefined

1.接收前台返回来的json字符串,并且封装到User对象里面

(题外话:前台页面可以使用JSON.stringify函数把元素打成json串,指定内容格式为json,发送ajax请求到后台)

@GetMapping("/one")
@ResponseBody
public Result one(@RequestBody User user){
    return ResultGenerator.getSuccessful(user.toString());
}
​
//预估会接收一个json串,然后又传回去(别纠结,只是做演示,正常会有逻辑操作)

undefined

@RequestParam,@RequestBody,@ResponseBody,@PathVariable注解的一点小总结
发生了405错误,这是因为我们在错误的地方使用了POST请求,后台接收用了Get请求,没有对上,这也是非常常见的错误,修改方法也很简单

把后台的Get请求修改成Post请求(一般使用这种)

前台发送Get请求

//修改过后
​
//output
{
    "code": 200,
    "msg": "User(name=Amg, age=22, gender=男, motto=该吃吃,该喝喝,遇事别往心里搁)",
    "data": null
}

至于@ResponseBody注解的演示,可是一直有在用,返回去的格式就是json格式串

三、@PathVariable

刚刚说了,该注解是接收url后面的变量的,使用起来也很方便,看一个小例子

//测试的接口:localhost:8080/testPathVariable/one/3024166
​
@GetMapping("/one/{id}")
public Result one(@PathVariable("id") String id){
    return ResultGenerator.getSuccessful("接收回来的路径是:" + id);
}
​
//output
{
    "code": 200,
    "msg": "接收回来的路径是:3024166",
    "data": null
}

以上注解都是日常工作中会用到的,今天抽了点时间做个小总结… 是时候打游戏去了(游戏不香嘛!!)

最后,感谢你的观看,如果觉得有收获的话,请帮忙点个赞

(关注公众号:码农Amg ,一位刚毕业的搬砖工,会不定期的分享工作中遇到的坑和学习小总结,时常还会分享沙雕日常,欢迎胖友们一起沟通交流)

一起努力学习,天天向上(emmm我们下期见吧,休息一下吧)

Original: https://www.cnblogs.com/iamamg97/p/13735782.html
Author: 码农Amg
Title: @RequestParam,@RequestBody,@ResponseBody,@PathVariable注解的一点小总结

原创文章受到原创版权保护。转载请注明出处:https://www.johngo689.com/570345/

转载文章受原作者版权保护。转载请注明原作者出处!

(0)

大家都在看

亲爱的 Coder【最近整理,可免费获取】👉 最新必读书单  | 👏 面试题下载  | 🌎 免费的AI知识星球