请求接收与参数绑定

SpringMVC通过参数绑定机制将请求数据自动映射到控制器方法参数。

参数绑定原理

SpringMVC使用HandlerAdapter调用控制器方法，通过HandlerMethodArgumentResolver解析参数：

HTTP请求 → DispatcherServlet → HandlerAdapter → ArgumentResolver → 方法参数

支持的参数类型

Servlet API

@RequestMapping("/servlet")
public String servlet(HttpServletRequest request,
                      HttpServletResponse response,
                      HttpSession session) {
    return "success";
}

基本类型

@RequestMapping("/basic")
public String basic(Integer id, String name, Boolean active) {
    return "success";
}

POJO对象

@RequestMapping("/pojo")
public String pojo(User user) {
    return "success";
}

数组与集合

@RequestMapping("/array")
public String array(@RequestParam("id") Integer[] ids,
                    @RequestParam("name") List<String> names) {
    return "success";
}

路径变量

@RequestMapping("/path/{id}")
public String path(@PathVariable Integer id) {
    return "success";
}

请求体

@RequestMapping("/body")
public String body(@RequestBody User user) {
    return "success";
}

参数绑定注解

默认参数绑定

SpringMVC自动绑定以下类型，无需注解：

综合示例

@RestController
@RequestMapping("/api")
public class ApiController {

    @GetMapping("/users/{id}")
    public User getUser(
        @PathVariable Integer id,
        @RequestParam(required = false) String name,
        @RequestHeader("User-Agent") String userAgent
    ) {
        User user = new User();
        user.setId(id);
        user.setName(name);
        return user;
    }

    @PostMapping("/users")
    public User createUser(
        @RequestBody User user,
        HttpServletRequest request,
        HttpSession session
    ) {
        user.setCreateTime(new Date());
        return userService.save(user);
    }
}

数据绑定流程

1. 解析请求参数名
2. 查找匹配的方法参数
3. 类型转换
4. 数据校验（如有@Valid）
5. 绑定到方法参数

参数名与请求参数名一致时可省略注解，不一致时需使用注解指定。

要点总结

• 参数绑定自动将请求数据映射到方法参数
• @RequestParam绑定请求参数，@PathVariable绑定路径变量
• POJO自动绑定同名属性
• Servlet API类型自动注入