【Spring Cloud】基于 Feign 实现远程调用，深入探索 Feign 的自定义配置、性能优化以及最佳实践方案

前言

在微服务架构中，服务之间的通信是至关重要的，而远程调用则成为实现这种通信的一种常见方式。在 Java 中，使用 RestTemplate 是一种传统的远程调用方式，但它存在一些问题，如代码可读性差、编程体验不一致以及参数复杂URL难以维护等。

在本文中，我们将探讨如何通过使用 Spring Cloud 中的 Feign 来解决这些问题，使得远程调用变得更加优雅和方便。

问题背景：使用 RestTemplate 远程调用存在的问题

考虑以下使用 RestTemplate 进行远程调用的代码：

String url = "http://userservice/user/" + order.getUserId();
User user = restTemplate.getForObject(url, User.class);

这段代码存在一些问题：

  • 可读性差： URL 拼接直接放在代码中，降低了代码的可读性。
  • 编程体验不统一： 使用 RestTemplate 和其他 HTTP 客户端的方式差异较大，不够统一。
  • 参数复杂URL难以维护： 当 URL 中的参数较多时，拼接字符串的方式难以维护和管理。

解决方案：使用 HTTP 客户端 Feign

Feign 是一个声明式的、模板化的 HTTP 客户端，是 Spring Cloud 生态中的一部分。它的设计目标是简化微服务架构中服务之间的通信，使得远程调用变得更加简单和优雅。

Feign 的基本概念：

  1. 声明式 API：

Feign 提供了一种声明式的 API 定义方式，通过接口的方式定义远程服务的调用。这种声明式的风格使得远程调用看起来就像是调用本地方法一样，大大提高了代码的可读性。

@FeignClient(name = "userservice")
public interface UserClient {@GetMapping("/user/{userId}")User getUser(@PathVariable("userId") String userId);
}

在上述代码中，@FeignClient 注解用于定义一个 Feign 客户端，@GetMapping 和 @PathVariable 注解用于定义远程调用的地址。

  1. 集成 Ribbon

Feign 默认集成了 Ribbon，这是一个负载均衡的客户端。通过与 Ribbon 的集成，Feign 能够实现对服务的负载均衡，提高了系统的可用性和稳定性。

  1. 支持 Hystrix

Hystrix 是一个熔断器框架，Feign 通过集成 Hystrix 提供了熔断器的支持。这意味着在远程服务不可用或响应时间过长时，Feign 能够执行预定义的降级逻辑，防止故障在整个系统中蔓延。

使用 Feign 的好处：

  1. 简化调用代码

通过使用 Feign，远程调用的代码变得简洁清晰。不再需要手动拼接 URL，而是通过接口的方式直接定义调用的方法和参数。

  1. 统一的编程体验

Feign 与其他 Spring Cloud 组件（如 Eureka、Ribbon、Hystrix 等）整合得很好，使得整体的编程体验更加统一。这样开发者在使用不同组件时，能够保持相似的编程风格。

  1. 内置负载均衡和熔断器

Feign 默认集成了 Ribbon 和 Hystrix，无需额外配置，就能够实现负载均衡和熔断器的功能。这使得系统更加健壮和可靠。

总而言之，Feign 是一个优秀的声明式 HTTP 客户端，它的设计使得远程调用变得更加简单和优雅。通过整合 Ribbon 和 Hystrix，Feign 提供了负载均衡和熔断器的支持，使得微服务架构中服务之间的通信更加健壮可靠。在构建微服务应用时，考虑使用 Feign，提高代码的可读性和系统的稳定性。

一、基于 Feign 的远程调用

1.1 引入依赖

在项目的 Maven 配置中，引入 Spring Cloud 和 Feign 的依赖：

<dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

1.2 启用 Feign

在 Spring Boot 应用的主类上添加 @EnableFeignClients 注解，以启用 Feign：

@SpringBootApplication
@EnableFeignClients
public class YourApplication {public static void main(String[] args) {SpringApplication.run(YourApplication.class, args);}
}

1.3 编写 Feign 客户端

创建一个接口，并使用 @FeignClient 注解指定服务的名称：

@FeignClient(name = "userservice")
public interface UserClient {@GetMapping("/user/{userId}")User getUser(@PathVariable("userId") String userId);
}

1.4 使用 Feign 客户端

在需要调用远程服务的地方，注入 UserClient 并调用相应的方法：

@Service
public class UserService {@Autowiredprivate UserClient userClient;public User getUserById(String userId) {return userClient.getUser(userId);}
}

通过上述步骤，就成功地使用了 Feign 进行远程服务调用。

二、Feign 的自定义配置

2.1 Feign 的自定义配置项

Feign 提供了一些自定义配置项，可以根据项目的需求进行调整。以下是一些常用的配置项：

类型作用说明
feign.Logger.Level修改日志级别控制 Feign 的日志输出级别，包含四种不同的级别：NONE、BASIC、HEADERS、FULL。
feign.codec.Decoder响应结果的解析器用于解析 HTTP 远程调用的结果，例如将 JSON 字符串解析为 Java 对象。
feign.codec.Encoder请求参数编码用于将请求参数编码，便于通过 HTTP 请求发送。
feign.Contract支持的注解格式定义 Feign 接口中支持的注解格式，默认是 SpringMVC 的注解。
feign.Retryer失败重试机制控制请求失败的重试机制，默认是没有重试，但会使用 Ribbon 的重试。

详细说明：

  1. feign.Logger.Level

    • 作用： 修改 Feign 的日志级别。
    • 说明： 控制 Feign 日志输出的详细程度，包括请求、响应的头信息和正文。级别分为：
      • NONE：不输出日志。
      • BASIC：仅输出请求方法、URL、响应状态码和执行时间。
      • HEADERS：在 BASIC 的基础上，输出请求和响应的头信息。
      • FULL：输出完整的请求和响应信息。
    @Configuration
public class FeignConfig {@Beanpublic Logger.Level feignLoggerLevel() {return Logger.Level.FULL; // 可根据需求调整日志级别}
}

  2. feign.codec.Decoder

    • 作用： 响应结果的解析器。
    • 说明： 用于将 HTTP 远程调用的结果解析为 Java 对象。通常情况下，Feign 会自动选择合适的解析器，比如将 JSON 字符串解析为 Java 对象。如果需要定制解析过程，可以实现 Decoder 接口。
    @Configuration
public class FeignConfig {@Beanpublic Decoder feignDecoder() {return new YourCustomDecoder(); // 自定义的解析器}
}

  3. feign.codec.Encoder

    • 作用： 请求参数编码。
    • 说明： 用于将请求参数编码，便于通过 HTTP 请求发送。通常情况下，Feign 会根据请求的数据类型自动选择合适的编码器，比如将 Java 对象编码为 JSON 字符串。如果需要定制编码过程，可以实现 Encoder 接口。
    @Configuration
public class FeignConfig {@Beanpublic Encoder feignEncoder() {return new YourCustomEncoder(); // 自定义的编码器}
}

  4. feign.Contract

    • 作用： 支持的注解格式。
    • 说明： 定义 Feign 接口中支持的注解格式，默认是 SpringMVC 的注解。可以根据项目需要选择其他的注解格式，例如 feign.Contract.Default 或自定义的 feign.Contract 实现。
    @Configuration
public class FeignConfig {@Beanpublic Contract feignContract() {return new feign.Contract.Default(); // 默认的注解格式}
}

  5. feign.Retryer

    • 作用： 失败重试机制。
    • 说明： 控制请求失败的重试机制，默认是没有重试，但会使用 Ribbon 的重试。可以通过自定义实现 Retryer 接口来定制重试策略。
    @Configuration
public class FeignConfig {@Beanpublic Retryer feignRetryer() {return new YourCustomRetryer(); // 自定义的重试策略}
}

以上是一些常见的 Feign 自定义配置项，根据具体项目的需求进行选择和调整。通过合理配置这些项，可以更好地满足系统的特定需求，提高 Feign 在微服务架构中的灵活性和适用性。

2.2 示例：配置 Feign 的日志级别

在使用 Feign 进行远程调用时，配置日志级别是一种常见的需求，以便更好地监控和调试远程调用过程。配置 Feign 的日志级别有两种方式：配置文件方式和 Java 代码方式。

1. 配置文件方式

首先，在项目的配置文件（例如 application.properties 或 application.yml）中配置 Feign 的日志级别。以下是一个示例，假设你的 Feign 客户端接口为 UserClient：

# 配置 Feign 的日志等级
feign:client:config:default:loggerLevel: FULL

这里的 UserClient 是你的 Feign 客户端接口的名称，按照规范是接口的类名首字母小写。通过这种方式，你可以为每个不同的 Feign 客户端设置不同的日志级别。

这是没有配置日志时访问输出的结果：

这是配置了 FULL 等级日志后访问输出的结果：

此时，输出完整的 HTTP 请求和响应信息。

2. Java 代码方式

如果要使用 Java 代码完成 Feign 日志的配置，则需要创建一个 Feign 的配置类，并配置 Feign 的日志 Bean 对象。

示例代码如下：

public class FeignConfig {@Beanpublic Logger.Level logLevel(){return Logger.Level.BASIC;}
}

但是，光有这个类，Feign 的日志并不会生效，还需要额外加上注解，这里有两种方式：

  1. 如果是针对所有的 Client 类都生效，则把这个类放到启动类的@EnableFeignClients注解中：
@EnableFeignClients(defaultConfiguration = FeignConfig.class)

例如：

  1. 如果这个配置只针对某个特定的 Feign 客户端生效，将配置类放到这个 Feign 客户端接口上的 @FeignClient 注解中：
@FeignClient(value = "userservice", configuration = FeignConfig.class)

例如：

通过以上的方式进行配置，我们可以灵活地控制 Feign 的日志输出，以适应不同环境和调试需求。

三、性能优化

在使用 Feign 进行远程调用时，性能优化是一个重要的方面，涉及到连接池的配置和日志级别的选择。下面将重点讨论 Feign 的性能优化，包括连接池配置和日志级别的优化。

3.1 Feign 的性能优化之连接池配置

Feign 的底层支持多种客户端实现，包括 URLConnection、Apache HttpClient 和 OKHttp。其中，URLConnection 是默认实现，不支持连接池，而 Apache HttpClient 和 OKHttp 支持连接池。

下面以添加 HttpClient 为例，进行 Feign 的连接池配置：

1. 添加 HttpClient 支持

首先，我们需要添加 HttpClient 的支持。在项目的 Maven 配置中引入 feign-httpclient 依赖：

<!-- 添加 HttpClient 支持 -->
<dependency><groupId>io.github.openfeign</groupId><artifactId>feign-httpclient</artifactId>
</dependency>

2. 配置连接池

接下来，我们需要配置连接池的相关参数。在配置文件（例如 application.yml）中添加如下配置：

feign:client:config:default:loggerLevel: BASIC # 日志级别，BASIC 表示基本的请求和响应信息httpclient:enabled: true # 开启 Feign 对 HttpClient 的支持max-connections: 200 # 最大的连接数max-connections-per-route: 50 # 每个路径的最大连接数

上述配置中，max-connections 表示最大的连接数，max-connections-per-route 表示每个路径的最大连接数。通过这样的配置，我们可以充分利用连接池来提高远程调用的性能。

3.2 Feign 的性能优化之日志级别优化

Feign 的日志级别选择也对性能有一定的影响。在远程调用中，通常建议使用 BASIC 或 NONE 级别的日志，以减少不必要的日志输出，提高性能。

例如，在配置文件中，将 Feign 的日志级别设置为 BASIC：

feign:client:config:default:loggerLevel: BASIC # 日志级别，BASIC 表示基本的请求和响应信息

或者，如果不需要任何日志输出，可以将日志级别设置为

feign:client:config:default:loggerLevel: NONE # 不输出任何日志

选择适当的日志级别，可以降低日志输出的数量，减轻系统的负担，提高远程调用的性能。特别是在生产环境中，通常建议选择较低的日志级别，以减少不必要的日志信息。

综上所述，优化 Feign 的性能主要包括连接池的配置和日志级别的选择。通过使用连接池代替默认的 URLConnection，以及选择适当的日志级别，我们可以提高远程调用的效率，减轻系统负担。在实际项目中，根据具体需求和场景进行合理的配置，以达到性能优化的目的。

四、最佳实践方案

4.1 使用 Feign 存在的问题及解决方案

在使用 Feign 进行微服务间通信时，可能会出现接口定义的重复开发问题。例如，在服务提供者的 Controller 中定义了一个接口方法，而在服务消费者的 Feign Client 中也需要定义相同的接口方法。这样的重复开发显然是不够优雅和高效的。

问题描述：

以示例代码为例：

在 user-service 中的 UserController 中有以下方法：

@GetMapping("/{id}")
public User findById(@PathVariable("id") Long id) {return userService.queryById(id);
}

而在 order-service 中的 UserClient 中，需要定义相似的接口方法：

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

这两段代码的功能相似，但却存在重复的问题。

解决方案：

为了解决这个问题，我们可以考虑提前它们公共的代码，这个提取公共代码的方式则可以考虑使用继承或者抽取来实现。

4.2 方式一（继承）：定义统一的父接口

通过继承的方式，我们可以定义一个统一的父接口，包含了微服务间通信的所有可能方法。

如下图所示：

以下是详细的实现步骤：

  1. 定义统一的接口

    // UserAPI.java
public interface UserAPI {@GetMapping("/user/{id}")User findById(@PathVariable("id") Long id);
}

  2. 服务消费者的 Feign Client 继承接口

    // UserClient.java
@FeignClient(value = "userservice")
public interface UserClient extends UserAPI {// 这里无需再次定义方法，直接继承 UserAPI 即可
}

  3. 服务提供者的 Controller 实现接口

    // UserController.java
@RestController
public class UserController implements UserAPI {@Overridepublic User findById(@PathVariable("id") Long id) {// 实现业务逻辑}
}

通过这种方式，我们实现了统一的 API 定义，服务消费者直接继承接口，无需重复定义。服务提供者实现接口，确保了对外提供的接口和消费者使用的接口一致性。

优势：

  • 提高代码的一致性和可读性。
  • 统一接口定义，降低维护成本。

存在的问题：

  1. 紧密耦合： 继承接口的方式会引入服务提供者和服务消费者之间的紧密耦合。一旦服务提供者的接口发生变化，所有继承的 Feign Client 都需要进行相应的修改，这可能导致维护成本的增加。

  2. 不适用于当前形式的 Spring MVC： 在 Spring MVC 中，方法参数映射并不是通过继承关系来实现的，而是通过注解等机制。因此，直接继承可能并不是最合适的选择。

考虑到这些问题，采用抽取的方式，将 Feign Client 抽取为独立模块，通过独立的接口定义和配置来提供给服务消费者，确实是更加灵活和可维护的选择。

4.3 方式二（抽取）：抽取 Feign Client 为独立模块

在这个方式中，我们将 Feign Client 抽取为一个独立的模块，其中包含了所有服务的客户端、相关的实体类以及 Feign 的自定义配置。这个模块将被所有服务的消费者引入，从而实现对 Feign Client 的共享使用。

示例图：

在这个示例中，创建了一个名为 feign-api 的模块，它包含了所有服务的 Feign Client 接口 UserClient、相关的实体类 User，以及 Feign 的自定义配置 FeignConfig。

实现最佳实践方式二的步骤如下：

  1. 首先新创建一个模块，命名为feign-api，然后在 pom.xml 中引入feign的starter依赖
<!-- feign的starter依赖--><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency>
  1. 将 order-service 中编写的UserClient、User、FeignConfig等类都复制到feign-api项目中

  1. 在order-service中引入feign-api的依赖
<!--引入 deign-api 的依赖-->
<dependency><groupId>cn.demo.cloud</groupId><artifactId>feign-api</artifactId><version>1.0</version>
</dependency>
  1. 修改order-service中的所有与上述三个组件有关的import部分，改成导入feign-api中的包

  1. 重启测试

重新启动 order-service 服务，发现找不到 UserClinet 这个 Bean 对象：

其原因在于当定义的FeignClient不在 order-service 的SpringBootApplication的扫描包范围，此时这些FeignClient无法使用。

有两种方式解决：

  1. 指定FeignClient所在包
@EnableFeignClients(basePackages = "cn.itcast.feign.clients")
  1. 指定FeignClient字节码
@EnableFeignClients(clients = {UserClient.class})

优点：

  • 代码复用性： 将 Feign Client 抽取为独立模块，可以在多个微服务中实现代码的复用，避免了重复定义 Feign Client 接口和相关实体类。
  • 统一配置： 集中管理 Feign 的自定义配置，确保所有服务使用相同的配置，提高了配置的一致性。
  • 模块化： 将相关的内容放置在独立的模块中，使得项目结构更加清晰，易于维护和管理。

缺点：

  • 依赖冗余： 有时一个服务可能只会使用 feign-api 中的部分内容，例如仅仅需要其中的一个实体类，但却引入了整个 feign-api 模块，可能导致依赖的冗余。

注意事项：

  • 在设计 feign-api 模块时，需要根据实际需求进行合理的划分，确保模块中的内容是相关的、有复用性的。
  • 对于可能引入的依赖冗余问题，可以根据具体情况权衡使用方式一或方式二。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.hqwc.cn/news/124535.html

如若内容造成侵权/违法违规/事实不符，请联系编程知识网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

【iptables 实战】9 docker网络原理分析

【iptables 实战】9 docker网络原理分析

在开始本章阅读之前&#xff0c;需要提前了解以下的知识 阅读本节需要一些docker的基础知识&#xff0c;最好是在linux上安装好docker环境。提前掌握iptables的基础知识&#xff0c;前文参考【iptables 实战】 一、docker网络模型 docker网络模型如下图所示 说明&#xff1…
阅读更多...
【LeetCode热题100】--199.二叉树的右视图

【LeetCode热题100】--199.二叉树的右视图

199.二叉树的右视图 思路&#xff1a; 使用根->右->左方法进行遍历节点&#xff0c;同时记录层数&#xff0c;将当前层数与记录的层数进行比较&#xff0c;如果当前层数大于记录的层数&#xff0c;添加该元素&#xff0c;若当前层数小于记录的层数&#xff0c;说明该层已…
阅读更多...
Java8 Lambda.stream.sorted() 方法使用浅析分享

Java8 Lambda.stream.sorted() 方法使用浅析分享

文章目录 Java8 Lambda.stream.sorted() 方法使用浅析分享sorted() 重载方法一升序降序 sorted() 重载方法二升序降序多字段排序 mock代码 Java8 Lambda.stream.sorted() 方法使用浅析分享 本文主要分享运用 Java8 中的 Lambda.stream.sorted方法排序的使用&#xff01; sorted…
阅读更多...
接口测试复习

接口测试复习

一。基本概念 接口概念&#xff1a;系统与系统之间 数据交互的通道。 接⼝测试概念&#xff1a;校验 预期结果 与 实际结果 是否⼀致。 特征&#xff1a; 测试⻚⾯测试发现不了的问题。&#xff08;因为&#xff1a;接⼝测试 绕过前端界⾯。 &#xff09; 符合质量控制前移理…
阅读更多...
redis5.0配置一主两从三哨兵

redis5.0配置一主两从三哨兵

基础配置 systemctl stop firewalld && systemctl disable firewalld setenforce 0 sed -i s/SELINUXenforcing/SELINUXdisabled/ /etc/selinux/configvi /etc/hosts ip1 node1 ip2 node2 ip3 node3redis 配置一主两从 yum -y install autoconf automake bison byac…
阅读更多...
【软考】系统集成项目管理工程师（六）项目整体管理【6分】

【软考】系统集成项目管理工程师（六）项目整体管理【6分】

一、 前言 1、项目管理三从四得 2、ITO共性总结 1、上一个过程的输出大部分是下-个过程的输入 2、计划和文件是不一样的 (每个输入都有计划和文件) 3、被批准的变更请求约等于计划 4、在执行和监控过程产生新的变更请求(变更请求包括变什么和怎么变&#xff0c;这是变更请求和…
阅读更多...
C++_pen_静态与常量

C++_pen_静态与常量

成员 常成员、常对象&#xff08;C推荐使用 const 而不用#define,mutable&#xff09; const 数据成员只在某个对象生存周期内是常量&#xff0c;而对于整个类而言却是可变的&#xff08;static除外&#xff09; 1.常数据成员&#xff08;构造函数初始化表赋值&#xff09; c…
阅读更多...
使用VSCode插件开发Hyperledger Fabric智能合约（链码）

使用VSCode插件开发Hyperledger Fabric智能合约（链码）

背景 开发Fabric链码对于开发者而言步骤繁琐&#xff1a;需要部署节点、安装链码、重启网络等操作。当前VSCode中的插件“Hyperledger Fabric Debugger”可以帮助我们迅速开发智能合约。 使用步骤 安装插件 在VSCode中安装Hyperledger Fabric Debugger插件 打开要开发链码的…
阅读更多...
注意力机制是否比矩阵分解更好？——IS ATTENTION BETTER THAN MATRIX DECOMPOSITION?

注意力机制是否比矩阵分解更好？——IS ATTENTION BETTER THAN MATRIX DECOMPOSITION?

原文链接&#xff1a;https://openreview.net/pdf?id1FvkSpWosOlhttps://openreview.net/pdf?id1FvkSpWosOl 代码库&#xff1a;​​​​​​​​​​​​​​GitHub - Gsunshine/Enjoy-Hamburger: [ICLR 2021 top 3%] Is Attention Better Than Matrix Decomposition?[ICL…
阅读更多...
微软输入法如何打勾和箭头的符号

微软输入法如何打勾和箭头的符号

文章目录 一、打 “√” 符号二、打 “←” 和 “→” 符号 一、打 “√” 符号 选中 “表情包” 图标 选中 “Ω” 符号后&#xff0c;下拉找到 “√” 即可。 微软输入法打 “ ”这个符号直接输入拼音“cha”就行。 二、打 “←” 和 “→” 符号 拼音直接打 “zuo” 或 “…
阅读更多...
Python+Requests+Pytest+YAML+Allure实现接口自动化

Python+Requests+Pytest+YAML+Allure实现接口自动化

本项目实现接口自动化的技术选型&#xff1a;PythonRequestsPytestYAMLAllure &#xff0c;主要是针对之前开发的一个接口项目来进行学习&#xff0c;通过 PythonRequests 来发送和处理HTTP协议的请求接口&#xff0c;使用 Pytest 作为测试执行器&#xff0c;使用 YAML 来管理测…
阅读更多...
MIP精确算法的关键——确定界

MIP精确算法的关键——确定界

目录 1.界是什么&#xff1f; 2. 如何更新上下界 2.1 以分支定界为框架的一系列算法 2.2 benders分解 MIP精确算法包含&#xff0c;分支定界、分支切割、分支定价还有benders分解等等。前者是以分支定界为框架的一类算法&#xff1b;后者是以分解为框架的一类算法。甚至还包…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023