Feign Client 原理和使用

最近一个新项目在做后端HTTP库技术选型的时候对比了`Spring WebClient`,`Spring RestTemplate`,`Retrofit`,`Feign`,`Okhttp`。综合考虑最终选择了上层封装比较好的`Feign`,尽管我们的App没有加入微服务，但是时间下来`Feign`用着还是很香的。

我们的sytyale针对`Feign`的底层原理和源码进行了解析，最后用一个小例子总结怎么快速上手。

> 本文作者：sytyale，另外一个聪明好学的同事

#### 一、原理

Feign 是一个 Java 到 HTTP 的客户端绑定器，灵感来自于 [Retrofit](https://github.com/square/retrofit) 和 [JAXRS-2.0](https://jax-rs-spec.java.net/nonav/2.0/apidocs/index.html) 以及 [WebSocket](http://www.oracle.com/technetwork/articles/java/jsr356-1937161.html)。Feign 的第一个目标是降低将 [Denominator](https://github.com/Netflix/Denominator)  无变化的绑定到 HTTP APIs 的复杂性，而不考虑 [ReSTfulness](http://www.slideshare.net/adrianfcole/99problems)。

Feign 使用 Jersey 和 CXF 等工具为 ReST 或 SOAP 服务编写 java 客户端。此外，Feign 允许您在 Apache HC 等http 库之上编写自己的代码。Feign 以最小的开销将代码连接到 http APIs，并通过可定制的解码器和错误处理（可以写入任何基于文本的 http APIs）将代码连接到 http APIs。

Feign 通过将注解处理为模板化请求来工作。参数在输出之前直接应用于这些模板。尽管 Feign 仅限于支持基于文本的 APIs，但它极大地简化了系统方面，例如重放请求。此外，Feign 使得对转换进行单元测试变得简单。

Feign 10.x 及以上版本是在 Java 8上构建的，应该在 Java 9、10 和 11上工作。对于需要 JDK 6兼容性的用户，请使用 Feign 9.x

#### 二、处理过程图


#### 三、Http Client 依赖

feign 在默认情况下使用 JDK 原生的 URLConnection 发送HTTP请求。(没有连接池，保持长连接) 。

可以通过修改 client 依赖换用底层的 client，不同的 http client 对请求的支持可能有差异。具体使用示例如下:

```yaml
feign: 
  httpclient:
    enable: false
  okhttp:
    enable: true
```

AND

```xml
<!-- Support PATCH Method-->
<dependency>    
  <groupId>org.apache.httpcomponents</groupId>    
  <artifactId>httpclient</artifactId> 
</dependency>
      
<!-- Do not support PATCH Method -->
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-okhttp</artifactId>
</dependency>
```

#### 四、Http Client 配置

* okhttp 配置源码

```java
@Configuration(proxyBeanMethods = false)
@ConditionalOnMissingBean(okhttp3.OkHttpClient.class)
public class OkHttpFeignConfiguration {

    private okhttp3.OkHttpClient okHttpClient;
  
    @Bean
    @ConditionalOnMissingBean(ConnectionPool.class)
    public ConnectionPool httpClientConnectionPool(
            FeignHttpClientProperties httpClientProperties,
            OkHttpClientConnectionPoolFactory connectionPoolFactory) {
        Integer maxTotalConnections = httpClientProperties.getMaxConnections();
        Long timeToLive = httpClientProperties.getTimeToLive();
        TimeUnit ttlUnit = httpClientProperties.getTimeToLiveUnit();
        return connectionPoolFactory.create(maxTotalConnections, timeToLive, ttlUnit);
    }

    @Bean
    public okhttp3.OkHttpClient client(OkHttpClientFactory httpClientFactory,
            ConnectionPool connectionPool,
            FeignHttpClientProperties httpClientProperties) {
        Boolean followRedirects = httpClientProperties.isFollowRedirects();
        Integer connectTimeout = httpClientProperties.getConnectionTimeout();
        this.okHttpClient = httpClientFactory
                .createBuilder(httpClientProperties.isDisableSslValidation())
                .connectTimeout(connectTimeout, TimeUnit.MILLISECONDS)
                .followRedirects(followRedirects).connectionPool(connectionPool).build();
        return this.okHttpClient;
    }

    @PreDestroy
    public void destroy() {
        if (this.okHttpClient != null) {
            this.okHttpClient.dispatcher().executorService().shutdown();
            this.okHttpClient.connectionPool().evictAll();
        }
    }
}
```

* HttpClient 配置源码

```java
@Configura