OpenFeign变身大揭秘：玩转参数传递和响应处理

2022-11-16 23:54:21

深入剖析 OpenFeign：掌控参数传递和响应处理

揭秘参数传递的奥秘

OpenFeign 赋予你掌控参数传递的强大力量，让你轻松实现微服务之间的通信。

@RequestParam：便捷的路径参数

只需在方法参数前加上 @RequestParam 注解，即可将参数传递到请求路径中。这就像在 Spring Web 中一样，简单直接。

@GetMapping("/user/{id}")
public User getUser(@RequestParam(value = "id") Long id);

例如，请求 /user/1 时，id 参数会自动填充为 1，方便从路径中获取。

@RequestBody：承载复杂的请求体

当需要传递复杂数据时，@RequestBody 注解派上用场。它将对象序列化为 JSON 并放入请求体中。

@PostMapping("/user")
public User createUser(@RequestBody User user);

请求时，user 对象会被序列化并发送至服务器。

@RequestHeader：定制请求头

@RequestHeader 注解让你能够在请求头中传递额外信息，用于授权、内容类型或其他自定义数据。

@GetMapping("/user")
public User getUser(@RequestHeader("Authorization") String token);

请求时，Authorization 头将被设置为 token 的值，从而携带身份验证信息。

驾驭响应处理

OpenFeign 不仅擅长参数传递，还提供灵活的响应处理机制。

实体对象返回：简单高效

当方法直接返回实体对象时，OpenFeign 会自动将响应体反序列化为 Java 对象。

@GetMapping("/user/{id}")
public User getUser(@PathVariable("id") Long id);

请求后，你会直接获取到 User 对象，无需进行额外的反序列化。

List 对象返回：处理集合

类似地，OpenFeign 也可以将响应体反序列化成 List 对象。

@GetMapping("/users")
public List<User> getUsers();

请求后，你会得到一个包含所有用户的 List，方便后续处理。

自定义响应：灵活性至上

如果你需要对响应进行更精细的控制，可以实现 ResponseDecoder 接口。这让你可以使用自定义解码器来处理响应，实现高度的灵活性。

快速上手：代码示例

下面是一些代码示例，供你参考：

// 使用 @RequestParam 接收路径参数
@GetMapping("/user/{id}")
public User getUser(@RequestParam(value = "id") Long id) {
    return userService.getUserById(id);
}

// 使用 @RequestBody 传递请求体
@PostMapping("/user")
public User createUser(@RequestBody User user) {
    return userService.createUser(user);
}

// 使用 @RequestHeader 设置请求头
@GetMapping("/user")
public User getUser(@RequestHeader("Authorization") String token) {
    return userService.getUserByToken(token);
}

// 返回实体对象
@GetMapping("/user/{id}")
public User getUser(@PathVariable("id") Long id) {
    return userService.getUserById(id);
}

// 返回 List 对象
@GetMapping("/users")
public List<User> getUsers() {
    return userService.getAllUsers();
}