Spring Boot 从“会用”到“精通”：参数绑定体系全景

// 源码位置：springboot2-master/boot-05-web-01/.../controller/ParameterTestController.java
@GetMapping("/car/{id}/owner/{username}")
public Map<String,Object> getCar(
    // 方式一：路径变量绑定
    @PathVariable("id") Integer id,              // URL: /car/2/owner/zhangsan → id=2
    @PathVariable("username") String name,        // → name="zhangsan"
    // 方式二：查询参数绑定
    @RequestParam("age") Integer age,             // ?age=28 → age=28
    @RequestParam("inters") List<String> inters,  // ?inters=1&inters=2 → [1,2]
    // 方式三：请求头 / Cookie 绑定
    @RequestHeader("User-Agent") String ua,       // 从请求头提取
    @CookieValue("_ga") Cookie cookie,            // 从 Cookie 提取
    // 方式四：POJO 对象绑定（无注解）
    Person person                                 // POST 表单 → Person 对象
) { ... }

参数有 @RequestBody？
    ├── 是 → RequestResponseBodyMethodProcessor
    │         └── HttpMessageConverter.read()（Jackson 反序列化整个 JSON → Java 对象）
    │              └── 然后可选地：WebDataBinder.validate()（@Valid 校验）
    │
    └── 否 → 各种命名参数解析器 / POJO 解析器
              └── WebDataBinder + ConversionService（逐字段 String → 目标类型转换）

@RequestBody Person person
    ↓
① HttpMessageConverter（Jackson）read() → 将 JSON 字节流反序列化为 Person 对象
    ↓
② Spring 为这个已填充的 Person 对象创建 WebDataBinder
    ↓
③ 如果方法参数上有 @Valid 注解 → WebDataBinder.validate(person) 触发 Hibernate Validator
    ↓
④ 校验结果放入 BindingResult
    ↓
⑤ 如果校验失败 → 抛出 MethodArgumentNotValidException

saveuser(Person person)  或  @RequestParam Date date
    ↓
① 解析器从 Request 中提取原始 String 值
    ↓
② WebDataBinder 创建（目标对象可能是空的，也可能是预填充的）
    ↓
③ WebDataBinder.bind() → 将 String K-V 绑定到对象属性
    ↓
④ 绑定过程中逐属性调用 ConversionService.convert() 进行类型转换
    ↓
⑤ 如果参数上有 @Valid → 触发校验
    ↓
⑥ 返回填充并校验完成的 Person 对象

请求到达 → 参数解析
    ↓
对于 @RequestBody：Jackson 先反序列化 → WebDataBinder.validate() 校验
对于 @RequestParam / POJO：WebDataBinder 先绑定 → WebDataBinder.validate() 校验
    ↓
如果校验失败：
    ├── BindingResult 收集错误信息
    ├── 如果方法签名中有 BindingResult 参数 → 不抛异常，由开发者自行处理
    └── 如果没有 BindingResult 参数 → 抛出异常（由全局异常处理器捕获）

@PostMapping("/save")
public String save(@Valid Person person, BindingResult result) {  // ✅ 正确
    if (result.hasErrors()) { ... }
}
@PostMapping("/save")
public String save(@Valid Person person, String other, BindingResult result) {  // ❌ 错误
    // BindingResult 没紧跟在 person 后面，Spring 无法关联
}

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public Map handleValidException(MethodArgumentNotValidException e) {
        Map<String, String> errors = new HashMap<>();
        e.getBindingResult().getFieldErrors().forEach(
            error -> errors.put(error.getField(), error.getDefaultMessage())
        );
        return Map.of("code", 400, "errors", errors);
    }
    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
    public Map handleTypeMismatch(MethodArgumentTypeMismatchException e) {
        return Map.of("code", 400, "msg", "参数 " + e.getName() + " 类型错误");
    }
}

                          HTTP 请求到达
                              │
              ┌───────────────┼───────────────┐
              │               │               │
        有 @RequestBody？  有 @RequestParam？  无注解 POJO？
              │               │               │
              ▼               ▼               ▼
    RequestResponseBody  RequestParam    ServletModelAttribute
    MethodProcessor      MethodArgument  MethodProcessor
    (读 JSON 流)         Resolver        (表单绑定)
                              │               │
              │               └───────┬───────┘
              │                       │
              │                       ▼
              │               WebDataBinder
              │               ├── bind()：K-V → 对象属性
              │               ├── ConversionService：String → 目标类型
              │               ├── validate()：@Valid 校验
              │               └── BindingResult：收集错误
              │
              ▼
      HttpMessageConverter.read()
      (Jackson 反序列化)
              │
              ▼
      WebDataBinder.validate()
      (@Valid 校验，仅此功能)
              │
              └───────────────┬───────────────┘
                              │
                              ▼
                    参数数组组装完成
                              │
                              ▼
                    reflection invoke()
                    Controller 方法执行