Spring Boot以其快速开发、简便配置的特性，成为了构建微服务架构的首选框架之一。在处理HTTP请求时，正确高效地读取请求参数是开发中的关键环节。Spring Boot提供了多种灵活的方式来读取API请求中的参数，包括查询参数、路径变量、请求体、请求头等。本文将通过比较与对比的方式，介绍六种常用的API请求参数读取方式。
- 查询参数（Query Parameters）
查询参数通常附加在URL后面，通过?分隔，多个参数之间用&连接。在Spring Boot中，可以通过@RequestParam注解来读取查询参数。
java
@GetMapping("/users")
public ResponseEntity getUsers(@RequestParam(name = "name", required = false) String name) {
// 使用name参数...
return ResponseEntity.ok("Name: " + name);
}
- 路径变量（Path Variables）
路径变量是URL路径的一部分，用于动态地匹配请求的URL。在Spring Boot中，通过{}在路径模板中定义变量，并通过@PathVariable注解读取。
java
@GetMapping("/users/{id}")
public ResponseEntity getUserById(@PathVariable("id") Long id) {
// 使用id参数...
return ResponseEntity.ok("User ID: " + id);
}
- 请求体（Request Body）
对于POST或PUT请求，请求体通常包含需要处理的数据。在Spring Boot中，可以使用@RequestBody注解来读取请求体中的数据，并将其自动绑定到Java对象上。
java
@PostMapping("/users")
public ResponseEntity createUser(@RequestBody User user) {
// 使用user对象...
return ResponseEntity.ok(user);
}
- 表单数据（Form Data）
当使用POST方法提交表单数据时，数据被编码为application/x-www-form-urlencoded格式。Spring Boot可以通过@ModelAttribute或@RequestParam（对于多个参数）来读取这些数据。
java
@PostMapping("/login")
public ResponseEntity login(@ModelAttribute UserCredentials credentials) {
// 使用credentials对象...
return ResponseEntity.ok("Logged in as " + credentials.getUsername());
}
- 请求头（Headers）
请求头包含了客户端发送给服务器的额外信息，如认证令牌、内容类型等。在Spring Boot中，可以使用@RequestHeader注解来读取特定的请求头。
java
@GetMapping("/data")
public ResponseEntity getData(@RequestHeader("Authorization") String authorization) {
// 使用authorization头信息...
return ResponseEntity.ok("Authorization: " + authorization);
}
- Cookie
Cookie是服务器发送到用户浏览器并保存在本地的一小块数据，它会在浏览器下次向同一服务器再发起请求时被携带并发送到服务器上。在Spring Boot中，可以使用@CookieValue注解来读取Cookie值。
java
@GetMapping("/welcome")
public ResponseEntity welcome(@CookieValue(name = "sessionId", defaultValue = "none") String sessionId) {
// 使用sessionId...
return ResponseEntity.ok("Session ID: " + sessionId);
}
对比总结
查询参数适用于简单的GET请求，用于传递少量信息。
路径变量用于URL路径的动态部分，便于构建RESTful风格的API。
请求体适用于POST和PUT请求，用于传输大量数据，如JSON或XML格式。
表单数据主要用于POST请求中的表单提交，适合键值对数据。
请求头常用于传递元数据信息，如认证令牌、内容类型等。
Cookie用于存储客户端的状态信息，如会话ID，实现跨请求的用户状态保持。
每种方式都有其适用场景，根据实际需求灵活选择，可以构建出高效、灵活的Spring Boot应用。
