SpringMVC中Controller层获取前端请求参数的几种方式

原创已于 2025-11-22 10:25:12 修改 · 1.5k 阅读

2 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

Spring

于 2023-08-24 12:32:00 首次发布

本文围绕SpringMVC参数绑定展开，介绍了自动绑定机制，即请求参数名和类型与方法形参相同时会自动绑定。还详细讲解了@RequestParam、@RequestBody、@PathVariable注解的使用，如@RequestParam可映射不同名参数，@RequestBody能将JSON转为Bean对象等，并通过PostMan测试验证。

1、SpringMVC自动绑定

在controller层方法中定义形参，若请求时参数名、参数类型相同，则SpringMVC会自动绑定。

	/**
     * @description: 测试springmvc自动绑定
     * @author: Vinci
     * @date: 2023/8/23 16:32
     **/
    @GetMapping("/automaticallyBindParameters")
    public String automaticallyBindParameters(String message,String test){
        return "message="+message + ",test="+test;
    }

下面使用PostMan进行测试发现，无论是将参数直接拼接到URL还是写在form-data里；只要参数类型和参数名与方法形参相同，则会自动绑定
在这里插入图片描述

2、使用@RequestParam 注解进行接收

当controller层中的方法形参名与请求参数名不同时，可使用@RequestParam进行映射
@RequestParam中的value属性指定请求参数名；
required属性指定该参数是否是必须传入的，默认是true（必须传入）；
defaultValue属性来指定当前参数的默认值（当形参没有传入值时生效）

	/**
     * @description: 测试@RequestParam注解
     * @author: Vinci
     * @date: 2023/8/24 8:28
     **/
    @GetMapping("/testRequestParam")
    public String testRequestParam(
            @RequestParam(value = "number",required = false,defaultValue = "1") int i
    ){
        return "number=" + i;
    }

接下来使用PostMan进行测试发现，传值则接收到值，不传值则使用默认值

在这里插入图片描述

3、@RequestBody注解

@RequestBody 注解可将 JSON数据转为 Bean对象, 与@ResponseBody注解作用相反

（1）使用实体来接收JSON

创建实体对象

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {

    private String id;

    private String username;

    private String password;

}

使用RequestBody接收

	/**
     * @description: 使用实体接收JSON
     * @author: Vinci
     * @date: 2023/8/24 9:01
     **/
    @GetMapping("/testReceiveJson")
    public String testReceiveJson(@RequestBody User user){
        return user.toString();
    }

PostMan测试结果
在这里插入图片描述

（2）使用 Map 集合接收JSON

	/**
     * @description: 使用Map接收JSON
     * @author: Vinci
     * @date: 2023/8/24 9:15
     **/
    @GetMapping("/testMapReceiveJson")
    public String testMapReceiveJson(@RequestBody Map<String,Object> maps){
        return maps.toString();
    }

PostMan测试结果
在这里插入图片描述

（3）使用 List集合接收JSON数组

	/**
     * @description: 使用List集合接收JSON数组
     * @author: Vinci
     * @date: 2023/8/24 9:17
     **/
    @GetMapping("/testListJson")
    public String testListJson(@RequestBody List<User> users){
        return users.toString();
    }

PostMan测试结果
在这里插入图片描述

4、@PathVariable 注解

可以使用@PathVariable注解获取url地址栏指定位置参数，url中的参数名需和controller形参一致，或是使用@PathVariable注解的value属性进行映射，在写@XXXMapping注解中的url时参数名需要使用 { } 括起来

	/**
     * @description: 使用@PathVariable注解获取地址栏指定位置参数
     * @author: Vinci
     * @date: 2023/8/24 9:32
     **/
    @GetMapping("/testGetAddressBarParameters/{id}")
    public String addressBarParameters(@PathVariable int id){
        return String.valueOf(id);
    }