精通前端、后端交流：@RequestParam和@RequestBody使用指南

2023-12-21 20:42:23

前端与后端交流必备：@RequestParam 与 @RequestBody

在前端与后端的数据交互中，正确接收和处理数据至关重要。@RequestParam 和 @RequestBody 是两大关键注解，帮助我们轻松应对这一难题。本文将深入探讨这两种注解的用法、适用场景和注意事项，助力开发者们高效构建交互系统。

@RequestParam：轻量级参数接收

@RequestParam 用于接收请求中的查询参数，即 URL 中 ? 号后面的部分。它适用于接收简单的请求数据，如字符串、数字和布尔值。

@RequestMapping("/hello")
public String hello(@RequestParam String name) {
    return "Hello, " + name + "!";
}

在上述代码中，方法 hello() 使用 @RequestParam 注解接收 name 查询参数，并将该值作为方法参数。

@RequestBody：复杂数据接收

当需要接收复杂数据，如 JSON 或 XML 时，@RequestBody 就派上用场了。它接收请求的 body 部分，并将其转换为指定的类型。

@RequestMapping("/save")
public void save(@RequestBody User user) {
    // ...
}

在此例中，方法 save() 使用 @RequestBody 注解接收请求 body，并将其解析为 User 对象。

适用场景

@RequestParam：

接收简单的查询参数
适用于 RESTful API 设计

@RequestBody：

接收复杂的 body 数据
适用于 RESTful API 设计

注意事项

@RequestParam 只能接收查询参数，而 @RequestBody 可以接收 body。
@RequestParam 可以接收多个参数，而 @RequestBody 只接收一个。
如果查询参数未指定，@RequestParam 参数值为 null。
如果 body 为空，@RequestBody 参数值为 null。

示例代码

以下代码展示了同时使用 @RequestParam 和 @RequestBody：

@RequestMapping("/hello")
public String hello(@RequestParam String name) {
    return "Hello, " + name + "!";
}

@RequestMapping("/save")
public void save(@RequestBody User user) {
    // ...
}

在该示例中，方法 hello() 使用 @RequestParam 接收 name 查询参数，而方法 save() 使用 @RequestBody 接收请求 body。

常见问题解答

发送请求时出现异常怎么办？

常见的异常包括：
- 400 Bad Request：请求格式不正确
- 401 Unauthorized：未经授权
- 403 Forbidden：禁止访问
- 404 Not Found：资源不存在
- 500 Internal Server Error：服务器内部错误
请检查 URL、参数、body 和授权信息是否存在问题。
如何避免 400 Bad Request？

确保请求符合预期格式，例如使用正确的参数名称和类型。
如何修复 401 Unauthorized？

检查请求中是否包含正确的授权信息，如 JWT 令牌。
如何解决 403 Forbidden？

确保用户具有访问请求资源的权限。
如何处理 500 Internal Server Error？

检查服务器是否正常运行，并修复任何错误。