什么是feign？

来自官网的解释：Feign makes writing java http clients easier

在使用feign之前，我们怎么发送请求？

拿okhttp举例：

    public static void post(String url, HashMap<String, String > paramsMap){
        OkHttpClient mOkHttpClient = new OkHttpClient();
        FormBody.Builder formBodyBuilder = new FormBody.Builder();
        Set<String> keySet = paramsMap.keySet();
        for(String key:keySet) {
            String value = paramsMap.get(key);
            formBodyBuilder.add(key,value);
        }
        FormBody formBody = formBodyBuilder.build();
        Request request = new Request
                .Builder()
                .post(formBody)
                .url(url)
                .build();
        try (Response response = mOkHttpClient.newCall(request).execute()) {
            System.out.println(response.body().string());
        }catch (Exception e){
            e.printStackTrace();
        }
    }

    public static void main(String[] args) {
        HashMap<String,String> paramsMap = new HashMap<String, String>() ;
        paramsMap.put("name","小明");
        paramsMap.put("html","<html>...");
        post("https://10.0.4.147:8015/crcc",paramsMap);
    }

 

有了feign之后我们怎么发送请求

@FeignClient(value = "FooBarService", configuration = FooBarServiceFeignConfiguration.class)
public interface FooBarService {
    @RequestMapping(value = "/foo", method = RequestMethod.GET)
    String foo(@RequestParam(value = "param1") String param1);

    @RequestMapping(value = "/bar", method = RequestMethod.POST)
    String bar(@RequestParam(value = "param1") String param1, @RequestParam(value = "param2") String param2);
}
@Autowired
FooBarService fooBarService;
public String foo() {
    return fooBarService.foo("rt");
}

几行代码就能搞定，很大程度的节省了工作量，而且客户端和服务端关于接口的定义只需要写一次

具体的利弊我们这里就不做分析，在微服务盛行的现在，服务之间的调用单纯使用http client的场景已经基本不存在 

 

spring cloud openfeign的加载过程

上面的代码为什么接口没有实现类也可以使用，是不是跟mybatis一样使用了代理？

没错，接口最后都会生成代理实现

（右键新标签打开可查看大图）

  

 spring cloud openfeign关于代理的生成过程

（右键新标签打开可看大图）

feign的REST Client API思想

JAX-RS标准

最新的REST接口标准为JAX-RS2.0，但是标准是供参考不能拿来直接吃的，具体还是要通过实现了标准的中间件来进行使用

JAX-RS2.0 之 REST Client API

摘自《Java RESTful Web Service实战（第2版）》

 为什么JAX-RS2.0这么去抽象，我们这里暂不深入去思考，先拿来主义

jersey

jersey是JAX-RS标准的参考实现，是Java领域中最纯正的REST服务开发框架，例如eureka也是使用jersey来做REST接口和客户端发送请求，详见《服务发现之eureka》 

jersey 之 REST Client API

官方文档示例

ClientConfig clientConfig = new ClientConfig();
clientConfig.register(MyClientResponseFilter.class);
clientConfig.register(new AnotherClientFilter());
 
Client client = ClientBuilder.newClient(clientConfig);
client.register(ThirdClientFilter.class);
 
WebTarget webTarget = client.target("http://example.com/rest");
webTarget.register(FilterForExampleCom.class);
WebTarget resourceWebTarget = webTarget.path("resource");
WebTarget helloworldWebTarget = resourceWebTarget.path("helloworld");
WebTarget helloworldWebTargetWithQueryParam =
        helloworldWebTarget.queryParam("greeting", "Hi World!");
 
Invocation.Builder invocationBuilder =
        helloworldWebTargetWithQueryParam.request(MediaType.TEXT_PLAIN_TYPE);
invocationBuilder.header("some-header", "true");
 
Response response = invocationBuilder.get();
System.out.println(response.getStatus());
System.out.println(response.readEntity(String.class));

 

feign与JAX-RS2.0

feign主要是作为客户端发送请求，所以也是参考对照了JAX-RS2.0标准

feign并不是REST Client，只是参考了REST Client的实现，具体的目标还是为了更简单的实现http client请求

feign中怎么进行对应呢？

为什么这么去抽象我们这里也暂不深入研究（更深层的JAX-RS为什么这么抽象还未探明） 

 

feign代理的执行流程和关键对象

代理生成时用到了什么组件、代理执行时用到了什么组件？

上文我们知道，所有请求最后都交给了MethodHandler来执行，所以我们重点关注MethodHandler即可

（右键新标签打开可查看大图）

 

MethodHandler的关键对象和执行请求的流程

  

1.RequestTemplate.Factory

创建RequestTemplate的工厂，包含MethodMetadata和Encoder对象

其中MethodMetadata是应用初始化时Contract解析@RequestMapping @RequestParam等注解而来的中间数据

2.Encoder 

报文压缩gzip等

3.RequestInterceptor

为请求附加一些信息，类似spring mvc的interceptor拦截器

4.Target

主要是把@FeignClient里的url拼接到RequestTemplate

5.Options 

用于请求的参数配置

6.Decoder 

解析返回报文，如果返回404，判断decode404==true则解析，否则交给ErrorDecoder解析

7.ErrorDecoder

请求错误处理

8.Logger.Level

日志等级，包含四种 none basic headers full

9.Logger

对应的配置为LoggerFactory，记录日志用

10.Retryer

重试，DefaultRetryer默认会重试5次

11.Client

真正执行http请求的客户端，可以配置，默认由FeignRibbonClientAutoConfiguration进行配置结合ribbon使用

  

spring cloud openfeign的配置

配置的优先级顺序

（右键新标签打开可查看大图）

 

properties和spring bean可以配置的内容

主要还是配置我们上面feign的关键对象，properties和spring bean可配置的项如下

 

同ribbon一样，spring-cloud-openfeign的配置也是懒加载，每个feignclient都可以有自己个性化的配置，且配置是懒加载的，但是为每个接口生成代理的时候已经去注册和使用了相关的配置，其实懒加载没有用了。

所以只实现了最终目的：每个feignclient 都可以有自己个性化的配置

这里的FeignContext跟ribbon的SpringClientFactory同理 

public class FeignContext extends NamedContextFactory<FeignClientSpecification> {
   public FeignContext() {
      super(FeignClientsConfiguration.class, "feign", "feign.client.name");
   }
}

 

feign与ribbon对接的关键点

 feign与ribbon对接主要还是在Client对象上做文章，将Client替换为继承Ribbon模板的实现类，这样就可以对执行请求前后做一些负载逻辑，详见《负载均衡之ribbon》

版权声明：本文为roytian原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/roytian/p/12196790.html