OpenFeign微服务调用组件

 

openfeign  调用慢，设置

前言

1.跨服务、跨进程调用方式

1）HttpURLConnection(了解)

HttpURLConnection 是 Java 的标准类，它继承自 URLConnection，可用于向指定网站发送 GET 请求、POST 请求。HttpURLConnection 使用比较复杂，不像 HttpClient 那样容易使用。

2）RestTemplate WebClient

RestTemplate 和 WebClient 是Spring Framework中用于进行HTTP通信的两个不同的类，提供了多种便捷访问远程 HTTP 服务的方法，能够大大提高客户端的编写效率

RestTemplate 是一个同步阻塞的HTTP客户端，它提供了一组方便的方法来发送HTTP请求并处理响应。它基于传统的Servlet API和Apache HttpClient库，可以在各种场景下使用，并且具有广泛的功能和配置选项。但是，由于是同步阻塞的，它在处理大量并发请求时可能会导致性能瓶颈。

WebClient 是一个非阻塞的、基于Reactive编程模型的HTTP客户端。它是Spring WebFlux模块的一部分，使用Reactor库来实现响应式编程。 WebClient 提供了一组异步的、链式的方法，可以发送HTTP请求并处理响应。它适用于高并发和异步场景，并且具有优秀的性能和可伸缩性。它还支持使用响应式流来处理大量的数据。

总的来说， RestTemplate 适用于传统的同步阻塞的HTTP通信，而 WebClient 适用于基于Reactive编程模型的异步非阻塞HTTP通信。选择使用哪个取决于你的项目需求和所采用的编程模型。对于新的Spring项目，推荐使用 WebClient 来利用响应式编程的优势。

SimpleClientHttpRequestFactory 和 HttpComponentsClientHttpRequestFactory 都是Spring框架中用于创建ClientHttpRequest实例的工厂类，

它们的主要区别在于底层使用的HTTP客户端库以及提供的特性和性能上的差异：

1.底层库：

SimpleClientHttpRequestFactory 使用Java标准库中的 HttpURLConnection 类来创建请求。这意味着它依赖于JDK自带的HTTP客户端实现，不需要额外的库依赖。

HttpComponentsClientHttpRequestFactory 则基于Apache HttpComponents项目中的 HttpClient 库来创建请求。HttpClient 是一个成熟的、功能丰富的HTTP客户端库，提供了更多的控制选项和更好的性能特性。

2.特性支持：

HttpURLConnection 提供的基础功能相对有限,对于复杂的HTTP请求处理(如连接池管理、SSL/TLS高级配置、重定向处理、请求超时控制等)可能需要额外的代码配置。

HttpClient 提供了更广泛的特性和配置选项，例如更灵活的连接管理（包括连接池）、更详细的SSL/TLS配置、自动处理重定向、更细粒度的超时控制、HTTP响应缓存等，这些特性在高并发或复杂网络环境下尤为重要。

RestTemplate默认使用的是SimpleClientHttpRequestFactory工厂，默认它是以java.net下的HttpURLConnection方式发起的请求。

3）Httpclient

HttpClient 是 Apache Jakarta Common 下的子项目，用来提供高效的、最新的、功能丰富的支持 Http 协议的客户端编程工具包，并且它支持 HTTP 协议最新版本。HttpClient 相比传统 JDK 自带的 URLConnection，提升了易用性和灵活性，使客户端发送 HTTP 请求变得容易，提高了开发的效率。

3.1设置restTemplate的工厂为HttpComponentsClientHttpRequestFactory

@Bean
  public RestTemplate restTemplate(){
    RestTemplate restTemplate = new RestTemplate();
    HttpComponentsClientHttpRequestFactory clientHttpRequestFactory = new HttpComponentsClientHttpRequestFactory();
    restTemplate.setRequestFactory(clientHttpRequestFactory);
    return restTemplate;
  }

4）Okhttp（了解）

一个处理网络请求的开源项目，是安卓端最火的轻量级框架，由 Square 公司贡献，用于替代 HttpUrlConnection 和 Apache HttpClient。OkHttp 拥有简洁的 API、高效的性能，并支持多种协议（HTTP/2 和 SPDY）。

上面介绍的是最常见的几种调用接口的方法，我们下面要介绍的方法比上面的更简单、方便，它就是 Feign。

OpenFeign微服务调用组件

1.Feign是什么

GitHub - OpenFeign/feign: Feign makes writing java http clients easier

Feign是Netflix开发的声明式、模板化的HTTP客户端， Feign可以帮助我们更快捷、优雅地调用HTTP API，目的是让编写HTTP接口的客户端变得更简洁和直接。

在Spring Cloud中，使用Feign非常简单——创建一个接口，并在接口上添加一些注解，代码就完成了。Feign支持多种注解，例如Feign自带的注解或者JAX-RS注解等。

Feign是一个声明式的Web服务客户端，让编写Web服务客户端变的更加容易。只需要创建一个接口并添加注解即可

优势：

Feign可以做到使用 HTTP 请求远程服务时就像调用本地方法一样的体验，开发者完全感知不到这是远程方法，更感知不到这是个 HTTP 请求，开发者无需关注与远程的交互细节，更无需关注分布式环境开发。

2.OpenFeign

Feign 和 OpenFeign 的区别（精简记忆版）？

1.支持spring mvc 注解

2.整合了更多的扩展 （请求重试策略、超时控制、请求拦截器）

3.Spring Cloud Alibaba快速整合OpenFeign

1）引入依赖

<!-- openfeign 远程调用 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

2）编写调用接口+@FeignClient注解

name: 服务名称，这是服务发现系统（如 Eureka 或 Nacos）中注册的服务名称。

3）调用端在启动类上添加@EnableFeignClients注解

@EnableFeignClients: 启用 Feign 客户端的支持。通过类路径扫描找到所有的 @FeignClient 注解接口，并将它们注册为 Bean。

4）发起调用，像调用本地方法一样调用远程服务

5）Feign 使用 @SpringQueryMap 来解决多参数传递问题

在实际项目开发过程中 ， 我们使用 Feign 实现了服务与服务之间的调用。但是在很多情况下，多参数传递是无法避免的。在 Web 开发中，Spring MVC 是支持 GET方法直接绑定 POJO的。但是 Feign 的实现并没有覆盖所有的Spring MVC 的功能。

在跨服务调用过程中如果使用的是Get请求，同时传递多个参数，一般我们会使用对象作为参数，Feign底层默认将对象转换成消息体，使用Post去请求第三方服务。

所以要加@SpringQueryMap 注解，

@SpringQueryMap是Spring-cloud-openfeign-core包中的一个注解，用于微服务之间的调用，使用于HTTP的Get请求参数映射到URL参数上 ?id=1&name=张三。

具体来说，@SpringQueryMap注解将会扫描方法参数中的字段或属性，拼接到URL上。

这样就可以方便地将多个查询参数组合成一个对象，从而简化参数传递和处理过程。

4.高级配置

Feign 提供了很多的扩展机制，让用户可以更加灵活的使用。

4.1 日志配置

有时候我们遇到 Bug，比如接口调用失败、参数没收到等问题，或者想看看调用性能，就需要配置 Feign 的日志了，以此让 Feign 把请求信息输出来。

Feign 提供了日志打印功能，我们可以通过配置来调整日志级别，从而了解 Feign 中 Http 请求的细节。说白了就是对Feign接口的调用情况进行监控和输出

通过源码可以看到日志等级有 4 种，分别是：

• NONE【性能最佳，适用于生产】：不记录任何日志（默认值）。

• BASIC【适用于生产环境追踪问题】：仅记录请求方法、URL、响应状态代码以及执行时间。

• HEADERS：记录BASIC级别的基础上，记录请求和响应的header。

• FULL【比较适用于开发及测试环境定位问题】：记录请求和响应的header、body和元数据。

4.1.1 全局配置

注意一：此处配置@Configuration注解就会全局生效，（如果想指定某一个服务生效，就不能加这个注解@Configuration ）

注意二： 因为feign调试日志是debug级别输出, SpringBoot默认的日志级别是Info，所以feign的debug日志级别就不会输出，一定要结合

logging.level.com.beiyou = debug

@Configuration
public class FeignConfig
{
    @Bean
    Logger.Level feignLoggerLevel()
    {
        return Logger.Level.FULL;
    }
}

4.1.2 局部配置

局部配置，让调用的微服务生效，在@FeignClient 注解中指定使用的配置类, 局部配置的时候 FeignConfig要去掉@Configuration注解

4.1.3 在配置文件配置

logging.level.com.beiyou = debug开启日志
##配置feign 的日志级别
#-- default 全局配置
feign.client.config.default.loggerLevel=NONE
#-- nacos-a 具体服务名
feign.client.config.nacos-a.loggerLevel=FULL

4.2 超时配置

若服务提供者的请求处理时间超过了请求处理的超时时间，则会报Read timed out错误，如下图所示：

4.2.1 全局配置

为了避免服务调用连接和处理时间超时，我们可以对feign的连接超时时间和请求处理超时时间进行配置。通过 Options 可以配置连接超时时间和读取超时时间

@Configuration
public class FeignConfig {
    @Bean
    public Request.Options options() {
      return new Request.Options(10L, TimeUnit.SECONDS, 60L,TimeUnit.SECONDS,false);
    }
}

注：Options 的第一个参数是连接的超时时间（ms)，默认值是2s；第二个参数是请求处理的超时时间（ms)，默认值是5s。

4.2.2 配置文件中配置

#全局配置
#这里 default 是一个特殊的客户端名称，用于表示全局配置,
#设置 connectTimeout 和 readTimeout 属性的值来定义全局的连接超时时间和读取超时时间。

feign.client.config.default.connectTimeout=5000
feign.client.config.default.readTimeout=10000

#局部配置 请将 <clientName> 替换为实际的Feign客户端名称。
feign.client.config.<clientName>.connectTimeout=5000
feign.client.config.<clientName>.readTimeout=10000

feign.client.config.order-service.connectTimeout=5000    #连接超时时间（ms)，默认值是2s
feign.client.config.order-service.readTimeout=10000      #请求处理的超时时间（ms)，默认值是5s

4.3 自定义拦截器(重要 重要 重要.......)

我们可以通过在OpenFeign中自定义拦截器的方式，来实现服务远程调用过程中的日志输出、认证授权等应用。

注：

• OpenFeign 中的拦截器是对服务调用者（也叫消费者）调用服务提供者的过程进行拦截。

• Spring MVC 中的拦截器是对客户端（浏览器）请求服务端的过程进行拦截。

接下来，我们通过输出日志的例子来介绍OpenFeign中拦截器的使用步骤：

4.3.1 自定义OpenFeign拦截器类

在服务消费者项目中创建一个名称为TraceIdFeignInterceptor 的拦截器类，并让其继承RequestInterceptor类。

@Slf4j
//@Component
public class TraceIdFeignInterceptor implements RequestInterceptor {
    @Override
    public void apply(RequestTemplate template) {

        log.debug("请求拦截了");

    }
}

4.3.2 配置拦截器

1）全局配置

我们可以在配置类中配置自定义的OpenFeign拦截器。

@Configuration
public class FeignConfig {
    @Bean
    public TraceIdFeignInterceptor feignInterceptor(){
        return new TraceIdFeignInterceptor ();
    }
}

2）局部配置

我们也可以在application.yaml文件中对自定义的OpenFeign拦截器进行局部配置。

# 拦截器
feign.client.config.order-service.requestInterceptors[0]=com.beiyou.TraceIdFeignInterceptor #自定义拦截器的完整类路径
feign.client.config.order-service.requestInterceptors[1]=com.beiyou.xxxxxxxxx

3）常用简化版

5.契约配置（了解）

Spring Cloud 在 Feign 的基础上做了扩展，使用 Spring MVC 的注解来完成Feign的功能。原生的 Feign 是不支持 Spring MVC 注解的，如果你想在 Spring Cloud 中使用原生的注解方式来定义客户端也是可以的，通过配置契约来改变这个配置，Spring Cloud 中默认的是 SpringMvcContract。

Spring Cloud 1 早期版本就是用的原生Fegin. 随着netflix的停更替换成了Open feign

1）修改契约配置，支持Feign原生的注解

注意：修改契约配置后，OrderFeignService 不再支持springmvc的注解，需要使用Feign原生的注解

/**
 * 修改契约配置，支持Feign原生的注解
 */
@Bean
public Contract feignContract() {
    return new Contract.Default();
}

2）OrderService 中配置使用Feign原生的注解

@FeignClient(value = "order-service")
public interface OrderService {
    @RequestLine("GET /hello")
    public String hello();
}

3）也可以通过yml配置契约

feign:
  client:
    config:
      order-service:  #对应微服务
        loggerLevel: FULL
        contract: feign.Contract.Default   #指定Feign原生注解契约配置