SpringBootWeb 篇-深入了解请求响应（服务端接收不同类型的请求参数的方式）

在Spring Boot Web开发中，处理请求和响应是一个非常重要的部分。通过了解如何接收不同类型的请求参数，可以更好地设计和实现RESTful API。本文将深入探讨Spring Boot中接收请求参数的几种方式，并给出相应的代码示例。

一、请求参数的接收方式

在Spring Boot中，主要有以下几种方式来接收请求参数：

1. @RequestParam：用于接收URL参数。
2. @PathVariable：用于接收URI中的变量。
3. @RequestBody：用于接收请求体中的JSON数据。
4. @RequestHeader：用于接收请求头中的数据。
5. @CookieValue：用于接收Cookie中的数据。

二、示例代码

1. @RequestParam

@RequestParam注解用于从请求的URL中获取参数。假设我们有一个查询用户的接口，可以这样实现：

@RestController
@RequestMapping("/user")
public class UserController {

    @GetMapping("/query")
    public ResponseEntity<String> queryUser(@RequestParam String name, @RequestParam(defaultValue = "18") Integer age) {
        return ResponseEntity.ok("查询用户：姓名：" + name + "，年龄：" + age);
    }
}

调用示例：GET /user/query?name=张三&age=25

2. @PathVariable

@PathVariable用于获取URI中的动态参数。可以用来获取RESTful API中的资源标识：

@RestController
@RequestMapping("/user")
public class UserController {

    @GetMapping("/info/{id}")
    public ResponseEntity<String> getUserInfo(@PathVariable Long id) {
        return ResponseEntity.ok("用户ID：" + id);
    }
}

调用示例：GET /user/info/1

3. @RequestBody

@RequestBody用于接收请求体中的JSON数据，常用于POST请求。我们可以定义一个用户对象：

@Data
public class User {
    private String name;
    private Integer age;
}

@RestController
@RequestMapping("/user")
public class UserController {

    @PostMapping("/create")
    public ResponseEntity<String> createUser(@RequestBody User user) {
        return ResponseEntity.ok("创建用户：姓名：" + user.getName() + "，年龄：" + user.getAge());
    }
}

调用示例：POST /user/create，请求体为：

{
    "name": "李四",
    "age": 28
}

4. @RequestHeader

@RequestHeader可以提取请求头中的信息，例如获取用户代理（User-Agent）：

@RestController
@RequestMapping("/user")
public class UserController {

    @GetMapping("/header")
    public ResponseEntity<String> getUserAgent(@RequestHeader("User-Agent") String userAgent) {
        return ResponseEntity.ok("用户代理：" + userAgent);
    }
}

调用示例：GET /user/header，请求头中携带User-Agent信息。

5. @CookieValue

@CookieValue用于从请求中提取Cookie值：

@RestController
@RequestMapping("/user")
public class UserController {

    @GetMapping("/cookie")
    public ResponseEntity<String> getCookieValue(@CookieValue(value = "SESSIONID", defaultValue = "No Cookie") String sessionId) {
        return ResponseEntity.ok("SESSIONID：" + sessionId);
    }
}

调用示例：GET /user/cookie，请求中带有SESSIONID Cookie。

三、总结

了解了Spring Boot中不同方式处理请求参数的方法后，我们可以根据具体需求选择合适的注解。每种注解都有其特定的场景，可以大大增加API的灵活性与可读性。在实际开发中，我们通常会结合使用这些注解，以满足复杂的业务需求。

通过以上示例代码，我们可以看到Spring Boot对请求参数的处理是非常便捷和直观的。希望本文能为您在Spring Boot Web开发中提供一些帮助和指导。