0


【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")publicinterfaceUserClient{@GetMapping("/user/{userId}")UsergetUser(@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@EnableFeignClientspublicclassYourApplication{publicstaticvoidmain(String[] args){SpringApplication.run(YourApplication.class, args);}}

1.3 编写 Feign 客户端

创建一个接口,并使用

@FeignClient

注解指定服务的名称:

@FeignClient(name ="userservice")publicinterfaceUserClient{@GetMapping("/user/{userId}")UsergetUser(@PathVariable("userId")String userId);}

1.4 使用 Feign 客户端

在需要调用远程服务的地方,注入

UserClient

并调用相应的方法:

@ServicepublicclassUserService{@AutowiredprivateUserClient userClient;publicUsergetUserById(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:输出完整的请求和响应信息。@ConfigurationpublicclassFeignConfig{@BeanpublicLogger.LevelfeignLoggerLevel(){returnLogger.Level.FULL;// 可根据需求调整日志级别}}
  2. feign.codec.Decoder- 作用: 响应结果的解析器。- 说明: 用于将 HTTP 远程调用的结果解析为 Java 对象。通常情况下,Feign 会自动选择合适的解析器,比如将 JSON 字符串解析为 Java 对象。如果需要定制解析过程,可以实现 Decoder 接口。@ConfigurationpublicclassFeignConfig{@BeanpublicDecoderfeignDecoder(){returnnewYourCustomDecoder();// 自定义的解析器}}
  3. feign.codec.Encoder- 作用: 请求参数编码。- 说明: 用于将请求参数编码,便于通过 HTTP 请求发送。通常情况下,Feign 会根据请求的数据类型自动选择合适的编码器,比如将 Java 对象编码为 JSON 字符串。如果需要定制编码过程,可以实现 Encoder 接口。@ConfigurationpublicclassFeignConfig{@BeanpublicEncoderfeignEncoder(){returnnewYourCustomEncoder();// 自定义的编码器}}
  4. feign.Contract- 作用: 支持的注解格式。- 说明: 定义 Feign 接口中支持的注解格式,默认是 SpringMVC 的注解。可以根据项目需要选择其他的注解格式,例如 feign.Contract.Default 或自定义的 feign.Contract 实现。@ConfigurationpublicclassFeignConfig{@BeanpublicContractfeignContract(){returnnewfeign.Contract.Default();// 默认的注解格式}}
  5. feign.Retryer- 作用: 失败重试机制。- 说明: 控制请求失败的重试机制,默认是没有重试,但会使用 Ribbon 的重试。可以通过自定义实现 Retryer 接口来定制重试策略。@ConfigurationpublicclassFeignConfig{@BeanpublicRetryerfeignRetryer(){returnnewYourCustomRetryer();// 自定义的重试策略}}

以上是一些常见的 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 对象。

示例代码如下:

publicclassFeignConfig{@BeanpublicLogger.LevellogLevel(){returnLogger.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}")publicUserfindById(@PathVariable("id")Long id){return userService.queryById(id);}

而在

order-service

中的

UserClient

中,需要定义相似的接口方法:

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

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

解决方案:

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

4.2 方式一(继承):定义统一的父接口

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

如下图所示:

以下是详细的实现步骤:

  1. 定义统一的接口// UserAPI.javapublicinterfaceUserAPI{@GetMapping("/user/{id}")UserfindById(@PathVariable("id")Long id);}
  2. 服务消费者的 Feign Client 继承接口// UserClient.java@FeignClient(value ="userservice")publicinterfaceUserClientextendsUserAPI{// 这里无需再次定义方法,直接继承 UserAPI 即可}
  3. 服务提供者的 Controller 实现接口// UserController.java@RestControllerpublicclassUserControllerimplementsUserAPI{@OverridepublicUserfindById(@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 中引入feignstarter依赖
<!-- feign的starter依赖--><dependency><groupId>org.springframework.cloud</groupId><artifactId>spring-cloud-starter-openfeign</artifactId></dependency>
  1. order-service 中编写的UserClientUserFeignConfig等类都复制到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 模块时,需要根据实际需求进行合理的划分,确保模块中的内容是相关的、有复用性的。
  • 对于可能引入的依赖冗余问题,可以根据具体情况权衡使用方式一或方式二。

本文转载自: https://blog.csdn.net/qq_61635026/article/details/133487389
版权归原作者 求知. 所有, 如有侵权,请联系我们删除。

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

还没有评论