OpenFeign

快速入门

OpenFeign是一个声明式的http客户端，是SpringCloud在Eureka公司开源的Feign基础上改造而来。官方地址：GitHub - OpenFeign/feign: Feign makes writing java http clients easier

其作用就是基于SpringMVC的常见注解，帮我们优雅的实现http请求的发送。

上面是之前的代码，明显很繁琐

OpenFeign已经被SpringCloud自动装配，实现起来非常简单：

1. 引入依赖，包括OpenFeign和负载均衡组件SpringCloudLoadBalancer

1. 通过@EnableFeignClients注解，启用OpenFeign功能

1. 编写FeignClient

1. 使用FeignClient，实现远程调用

连接池

OpenFeign对Http请求做了优雅的伪装，不过其底层发起http请求，依赖于其它的框架。这些框架可以自己选择，包括以下三种：

• • HttpURLConnection：默认实现，不支持连接池
  • Apache HttpClient ：支持连接池
  • OKHttp：支持连接池

具体源码可以参考FeignBlockingLoadBalancerClient类中的delegate成员变量。

OpenFeign整合OKHttp的步骤如下：

1. 引入依赖

1. 开启连接池功能

最佳实践

当定义的FeignClient不在SpringBootApplication的扫描包范围时，这些FeignClient无法使用。有两种方式解决：

方式一：指定FeignClient所在包

方式二：指定FeignClient字节码

日志

OpenFeign只会在FeignClient所在包的日志级别为DEBUG时，才会输出日志。而且其日志级别有4级：

• • NONE：不记录任何日志信息，这是默认值。
  • BASIC：仅记录请求的方法，URL以及响应状态码和执行时间
  • HEADERS：在BASIC的基础上，额外记录了请求和响应的头信息
  • FULL：记录所有请求和响应的明细，包括头信息、请求体、元数据。

由于Feign默认的日志级别就是NONE，所以默认我们看不到请求日志。

要自定义日志级别需要声明一个类型为Logger.Level的Bean，在其中定义日志级别：

但此时这个Bean并未生效，要想配置某个FeignClient的日志，可以在@FeignClient注解中声明：

如果想要全局配置，让所有FeignClient都按照这个日志配置，则需要在@EnableFeignClients注解中声明：

总结：

如何利用OpenFeign实现远程调用？

• 引入OpenFeign和SpringCloudLoadBalancer依赖
• 利用@EnableFeignClients注解开启OpenFeign功能
• 编写FeignClient

如何配置OpenFeign的连接池？

• 引入http客户端依赖，例如OKHttp、HttpClient
• 配置yaml文件，打开OpenFeign连接池开关

OpenFeign使用的最佳实践方式是什么？

• 由服务提供者编写独立module，将FeignClient及DTO抽取

如何配置OpenFeign输出日志的级别？

• 声明类型为Logger.Level的Bean
• 在@FeignClient或@EnableFeignClients注解上使用