SpringBoot 中处理接口传参时常用的注解及使用场景分析

@RestController
@RequestMapping("/user")
public class UserController {
    // 访问路径：/user/123
    @GetMapping("/{id}")
    public String getUserById(@PathVariable Long id) {
        return "获取到用户ID：" + id;
    }
    // 多路径参数 + 指定参数名（参数名与路径变量名不一致时）
    @GetMapping("/{id}/order/{orderId}")
    public String getUserOrder(
        @PathVariable("id") Long userId, 
        @PathVariable("orderId") Long orderId
    ) {
        return "用户ID：" + userId + "，订单ID：" + orderId;
    }
}

@RestController
@RequestMapping("/user")
public class UserController {
    // 访问路径：/user/list?name=张三&age=20
    @GetMapping("/list")
    public String getUserList(
        @RequestParam String name, // 必传参数
        @RequestParam(required = false, defaultValue = "18") Integer age // 非必传+默认值
    ) {
        return "姓名：" + name + "，年龄：" + age;
    }
}

// 1. 定义POJO（接收前端JSON）
public class UserDTO {
    private String name;
    private Integer age;
    // 省略getter/setter
}
// 2. 控制器接收参数
@RestController
@RequestMapping("/user")
public class UserController {
    // 前端POST请求体：{"name":"张三","age":20}
    @PostMapping("/add")
    public String addUser(@RequestBody UserDTO userDTO) {
        return "新增用户：" + userDTO.getName() + "，年龄：" + userDTO.getAge();
    }
}

@RestController
@RequestMapping("/user")
public class UserController {
    @GetMapping("/info")
    public String getUserInfo(
        @RequestHeader("token") String token, // 获取token请求头
        @RequestHeader(value = "Accept-Language", required = false) String lang // 非必传
    ) {
        return "Token：" + token + "，语言：" + (lang == null ? "zh-CN" : lang);
    }
}

@RestController
@RequestMapping("/user")
public class UserController {
    @GetMapping("/cookie")
    public String getCookie(@CookieValue("JSESSIONID") String sessionId) {
        return "SessionID：" + sessionId;
    }
}

// 1. 简单类型自动绑定（访问路径：/user/simple?name=李四）
@GetMapping("/simple")
public String simpleParam(String name) {
    return "姓名：" + name;
}
// 2. POJO自动绑定（访问路径：/user/pojo?name=李四&age=22）
@GetMapping("/pojo")
public String pojoParam(UserDTO userDTO) {
    return "姓名：" + userDTO.getName() + "，年龄：" + userDTO.getAge();
}