不用找了,10分钟帮你搞定 feign+spring cloud!看完秒懂

  • 2020 年 3 月 13 日
  • 筆記

转载自:https://www.cnblogs.com/roytian/p/12196790.html

什么是feign?

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

https://github.com/OpenFeign/feign

在使用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》。