在 Spring 框架的 Web 开发中，处理 HTTP 请求参数是一项基础且重要的工作。除了 @PathVariable、@RequestParam 和 @Valid @RequestBody 外，还有一些其他注解也用于此目的。本文将对这些注解进行全面的区分和解析，帮助开发者在实际项目中更准确地选择和使用。

一、`@PathVariable`

1. 用途与原理

@PathVariable 用于从 URL 路径中提取变量值。它遵循 RESTful 架构风格，使 URL 能够直观地反映资源的标识符。Spring 会将 URL 中对应位置的变量值绑定到方法参数上。

2. 示例

假设我们有一个获取用户信息的接口，URL 为 /users/{id}，代码如下：

@GetMapping("/users/{id}")
public ResponseEntity<User> getUserById(@PathVariable Long id) {// 根据id查询用户User user = userService.findById(id);return ResponseEntity.ok(user);
}

3. 特点

路径相关性：紧密依赖 URL 路径结构，变量值直接嵌入路径中。
类型转换：支持自动类型转换，如将路径中的字符串转换为方法参数所需的 Long、Integer 等类型。若转换失败，会抛出异常。

二、`@RequestParam`

1. 用途与原理

@RequestParam 主要用于获取 URL 查询参数，即 ? 后面的键值对。Spring 会从请求的参数列表中找到对应名称的参数，并将其值绑定到方法参数上。

2. 示例

比如我们有一个搜索用户的接口，支持根据用户名和年龄范围进行筛选，URL 可能为 /users?name=John&minAge=18&maxAge=30，代码如下：

@GetMapping("/users")
public ResponseEntity<List<User>> searchUsers(@RequestParam(required = false) String name,@RequestParam(required = false, defaultValue = "0") int minAge,@RequestParam(required = false, defaultValue = "120") int maxAge) {List<User> users = userService.search(name, minAge, maxAge);return ResponseEntity.ok(users);
}

3. 特点

灵活性：参数在 URL 中以键值对形式呈现，可灵活添加、修改或删除，适用于传递各种可选的过滤、排序或分页参数。
默认值与必填性：可以通过 required 属性指定参数是否必填，通过 defaultValue 属性设置默认值。

三、`@Valid @RequestBody`

1. 用途与原理

@RequestBody 用于获取 HTTP 请求体中的数据，通常用于处理 JSON、XML 等格式的数据。@Valid 则用于对绑定后的 Java 对象进行校验，确保对象的属性符合预先定义的规则。

2. 示例

假设前端发送一个 JSON 格式的用户注册信息，我们的接口如下：

@PostMapping("/register")
public ResponseEntity<String> registerUser(@Valid @RequestBody UserRegistrationDto userDto) {userService.register(userDto);return ResponseEntity.ok("注册成功");
}

其中 UserRegistrationDto 类可能包含一些校验注解，如：

public class UserRegistrationDto {@NotNull(message = "用户名不能为空")private String username;@NotNull(message = "密码不能为空")@Size(min = 6, message = "密码长度至少为6位")private String password;// 省略getter和setter方法
}

3. 特点

处理复杂对象：非常适合处理包含多个属性的复杂对象，通过反序列化将请求体数据映射到 Java 对象。
数据校验：结合 @Valid 以及各种校验注解，可在方法执行前对数据进行严格校验，提高数据的准确性和安全性。

四、`@RequestHeader`

1. 用途与原理

@RequestHeader 用于获取 HTTP 请求头中的信息。Spring 会从请求头中找到指定名称的头信息，并将其值绑定到方法参数上。

2. 示例

获取请求头中的 User - Agent，代码如下：

@GetMapping("/info")
public ResponseEntity<String> getInfo(@RequestHeader("User - Agent") String userAgent) {return ResponseEntity.ok("您的浏览器信息: " + userAgent);
}

3. 特点

获取元数据：常用于获取与请求相关的元数据，如客户端类型、语言偏好、认证令牌等，这些信息对服务器处理请求有重要参考价值。
类型转换：与 @RequestParam 类似，支持基本类型和 String 类型的自动转换。

五、`@CookieValue`

1. 用途与原理

@CookieValue 用于获取 HTTP 请求中的 Cookie 值。Spring 会从请求的 Cookie 中找到指定名称的 Cookie，并将其值绑定到方法参数上。

2. 示例

获取名为 JSESSIONID 的 Cookie 值，代码如下：

@GetMapping("/session")
public ResponseEntity<String> getSessionInfo(@CookieValue("JSESSIONID") String sessionId) {return ResponseEntity.ok("您的会话ID: " + sessionId);
}