Spring Boot控制器中URL参数自动映射至POJO对象的特性解析

问题场景 #

我编写了如下Spring Boot控制器代码：

@RequestMapping("/hello")
public void callHello(MyObject myObject) {
    // 业务逻辑代码
}

其中MyObject是一个包含getter和setter方法的POJO类：

public class MyObject {
    private String fName;
    private String lName;
    // getter和setter方法
}

我通过以下Ajax请求调用该控制器接口：

var jqxhr = $.ajax({
    url:'hello?fName=testFname&lName=testLname',
    type:"GET",
    dataType:'JSON'
});

目前请求可以正常运行，我想了解Spring中实现URL参数自动映射至MyObject字段的这个特性是什么，它是怎么工作的？

解答 #

这个特性叫做Spring MVC数据绑定（Data Binding），是Spring MVC核心功能之一，专门用来简化请求参数到Java对象的映射处理。

核心工作流程： #

• 当控制器方法参数中声明了POJO类型（比如你的MyObject）时，Spring MVC会自动通过无参构造函数实例化这个对象。
• 随后它会遍历请求中的所有参数（这里就是URL里的查询参数fName和lName），将参数名与POJO的字段名进行匹配（大小写敏感，不过也可以通过配置支持驼峰与下划线的自动转换）。
• 匹配成功后，Spring会调用对应字段的setter方法，把参数值赋值给对象的字段。比如请求里的fName=testFname，就会触发myObject.setFName("testFname")完成赋值。

正常运行的前提条件： #

• 你的POJO必须存在无参构造函数：如果没有手动定义其他构造函数，Java会自动生成，无需额外编写；如果定义了带参构造，一定要手动添加无参构造，否则Spring无法实例化对象。
• 每个需要绑定的字段都要有对应的getter和setter方法：Spring依赖setter来设置字段值，getter则主要用于表单回显等后续场景。
• 参数名与POJO字段名匹配：如果需要自定义参数名和字段名的映射关系，可以在字段上使用@RequestParam注解指定对应参数名，不过GET请求中直接保持名称一致是最省心的方式。

另外，这个数据绑定能力不止支持GET请求的URL查询参数，还能处理POST请求的表单数据、JSON请求体（只要项目中配置了Jackson这类消息转换器），是Spring MVC大幅简化请求参数处理的实用特性。

内容的提问来源于stack exchange，提问作者user8710021