一篇了解springboot3请求参数种类及接口测试

news2025/10/31 10:56:52

SpringBoot3数据请求：

原始数据请求：

 //原始方式
    @RequestMapping("/simpleParam")
    public String simpleParam(HttpServletRequest request){
        //获取请求参数
        String name = request.getParameter("name");
        String age = request.getParameter("age");
        int age1 = Integer.parseInt(age);
        System.out.println(name+":"+ age1);
        return "ok";

    }

springboot数据请求方式：

 //springboot方式
    @RequestMapping("/simpleParam")
    public String simpleParam(String name,Integer age){
        //获取请求参数
        System.out.println(name+":"+ age);
        return "ok";

    }

一、简单实体参数：

**
@RequestParam注解的使用：方法形参名称与请求参数名称不匹配，可以使用@RequestParam完成映射。

在这里插入图片描述

 @RequestMapping("/simpleParam")
    public String simpleParam(@RequestParam(name="name",required = false) String username,Integer age){
        //获取请求参数
        System.out.println(username+":"+ age);
        return "ok";
    }

@RequestParam中的required属性默认为true，代表该请求参数必须传递，如果不传递将报错，如果该参数是可选中，可以将required属性设置为false。

如下图所示：
在这里插入图片描述

二、实体对象参数

规则：请求参数名与形参对象属性名相同，即可直接通过pojo接收。

User实体类

public class User {
    private String name;
    private Integer age;
    private Address address;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

    @Override
    public String toString() {
        return "User{" +
                "name='" + name + '\'' +
                ", age=" + age +
                ", address=" + address +
                '}';
    }

Address实体类

public class Address {
    private String province;
    private String city;

    public String getProvince() {
        return province;
    }

    public void setProvince(String province) {
        this.province = province;
    }

    public String getCity() {
        return city;
    }

    public void setCity(String city) {
        this.city = city;
    }

    @Override
    public String toString() {
        return "Address{" +
                "province='" + province + '\'' +
                ", city='" + city + '\'' +
                '}';
    }

在这里插入图片描述

三、数组集合参数：

数组参数： 请求参数名与形参数组名称相同且请求参数为多个，定义数组类形参即可接受参数。

 //数组集合参数
    @RequestMapping("/arrayParam")
    public String arrayParam(String[] hobby){
        System.out.println(Arrays.toString(hobby));
        return "ok";
    }

在这里插入图片描述

集合参数： 请求参数名与形参集合名称相同且请求参数为多个，@RequestParam绑定参数关系

 @RequestMapping("/listParam")
    public String listParam(@RequestParam List<String> hobby){
        System.out.println(hobby);
        return "ok";
    }

在这里插入图片描述

小结：

数组：请求参数名与形参中数组变量名相同，可以直接使用数组封装

集合：请求参数名与形参中集合变量名相同，通过@RequestParam绑定参数关系

四、日期参数

日期参数： 使用@DateTimeFormat注解完成日期参数格式转换

 //日期时间参数
    @RequestMapping("/dateParam")
    public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime){
        System.out.println(updateTime);
        return "ok";
    }

在这里插入图片描述

五、Json参数

Json参数： JSON数据键名与形参对象属性名相同，定义POJO类型形参即可接收参数，需要使用@RequestBody标识

 //json参数
    @RequestMapping("/jsonParam")
    public String jsonParam(@RequestBody User user){
        System.out.println(user);
        return "ok";
    }

在这里插入图片描述

六、路径参数

路径参数： 通过请求url直接传递参数，使用{…}来标识该路径参数，需要使用@PathVariable获取路径参数

 //路径参数
    @RequestMapping("/path/{id}")
    public String pathParam(@PathVariable Integer id){
        System.out.println(id);
        return "ok";
    }
    @RequestMapping("/path/{id}/{name}")
    public String pathParam2(@PathVariable Integer id,@PathVariable String name){
        System.out.println(id+":"+name);
        return "ok";
    }