Spring Cloud Alibaba Sentinel 整合 Feign 的设计实现

Stella981
• 阅读 637

Spring Cloud Alibaba Sentinel 整合 Feign 的设计实现

作者 | Spring Cloud Alibaba 高级开发工程师洛夜
来自公众号阿里巴巴中间件投稿

前段时间 Hystrix 宣布不再维护之后(Hystrix 停止开发。。。Spring Cloud 何去何从?),Feign 作为一个跟 Hystrix 强依赖的组件,必然会有所担心后续的使用。

作为 Spring Cloud Alibaba 体系中的熔断器 Sentinel,Sentinel 目前整合了 Feign,本文对整合过程做一次总结,欢迎大家讨论和使用。

Feign 是什么?

Feign 是一个 Java 实现的 Http 客户端,用于简化 Restful 调用。

Feign 跟 OkHttp、HttpClient 这种客户端实现理念不一样。Feign 强调接口的定义,接口中的一个方法对应一个 Http 请求,调用方法即发送一个 Http 请求;OkHttp 或 HttpClient 以过程式的方式发送 Http 请求。Feign 底层发送请求的实现可以跟 OkHttp 或 HttpClient 整合。

要想整合 Feign,首先要了解 Feign 的使用以及执行过程,然后看 Sentinel 如何整合进去。

Feign 的使用

需要两个步骤:

1、使用 `@EnableFeignClients` 注解开启 Feign 功能

@SpringBootApplication@EnableFeignClients // 开启 Feign 功能public class MyApplication {  ...}

@EnableFeignClients 属性介绍:

value:String[] 包路径。比如 org.my.pkg,会扫描这个包路径下带有 @FeignClient 注解的类并处理;

basePackages:String[] 跟 value 属性作用一致;

basePackageClasses:Class[] 跟 basePackages 作用一致,basePackages 是个 String 数组,而 basePackageClasses 是个 Class 数组,用于扫描这些类对应的 package;

defaultConfiguration:Class[] 默认的配置类,对于所有的 Feign Client,这些配置类里的配置都会对它们生效,可以在配置类里构造 feign.codec.Decoderfeign.codec.Encoder 或 feign.Contract 等bean;

clients:Class[] 表示 @FeignClient; 注解修饰的类集合,如果指定了该属性,那么扫描功能相关的属性就是失效。比如 value、basePackages 和 basePackageClasses;

2、使用 `@FeignClient` 注解修饰接口,这样会基于跟接口生成代理类

@FeignClient(name = "service-provider")public interface EchoService {  @RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)  String echo(@PathVariable("str") String str);}

只要确保这个被 @FeignClient 注解修饰到的接口能被 @EnableFeignClients 注解扫描到,就会基于 java.lang.reflect.Proxy 根据这个接口生成一个代理类。

生成代理类之后,会被注入到 ApplicationContext 中,直接 AutoWired 就能使用,使用的时候调用 echo 方法就相当于是发起一个 Restful 请求。

@FeignClient 属性介绍:

value:String 服务名。比如 service-providerhttp://service-provider。比如 EchoService 中如果配置了 value=service-provider,那么调用 echo 方法的 url 为 http://service-provider/echo;如果配置了 value=https://service-provider,那么调用 echo 方法的 url 为 https://service-provider/divide

serviceId:String 该属性已过期,但还能用。作用跟 value 一致
name:String 跟 value 属性作用一致

qualifier:String 给 FeignClient 设置 @Qualifier 注解

url:String 绝对路径,用于替换服务名。优先级比服务名高。比如 EchoService中如果配置了 url=aaa,那么调用 echo 方法的 url 为http://aaa/echo;如果配置了 url=https://aaa,那么调用 echo 方法的 url 为 https://aaa/divide

decode404:boolean 默认是 false,表示对于一个 http status code 为 404 的请求是否需要进行 decode,默认不进行 decode,当成一个异常处理。设置为true之后,遇到 404 的 response 还是会解析 body

configuration:Class[] 跟 @EnableFeignClients 注解的 defaultConfiguration 属性作用一致,但是这个对于单个 FeignClient 的配置,而 @EnableFeignClients 里的 defaultConfiguration 属性是作用域全局的,针对所有的 FeignClient

fallback:Class 默认值是 void.class,表示 fallback 类,需要实现 FeignClient 对应的接口,当调用方法发生异常的时候会调用这个 Fallback 类对应的 FeignClient 接口方法。

如果配置了 fallback 属性,那么会把这个 Fallback 类包装在一个默认的 FallbackFactory 实现类 FallbackFactory.Default 上,而不使用 fallbackFactory 属性对应的 FallbackFactory 实现类

fallbackFactory:Class 默认值是 void.class,表示生产 fallback 类的 Factory,可以实现 feign.hystrix.FallbackFactory 接口,FallbackFactory 内部会针对一个 Throwable 异常返回一个 Fallback 类进行 fallback 操作

path:String 请求路径。 在服务名或 url 与 requestPath 之间

primary:boolean 默认是 true,表示当前这个 FeignClient 生成的 bean 是否是 primary。

所以如果在 ApplicationContext中存在一个实现 EchoService 接口的 Bean,但是注入的时候并不会使用该Bean,因为 FeignClient 生成的 Bean 是 primary

Feign 的执行过程

了解了 Feign 的使用之后,接下来我们来看 Feign 构造一个 Client 的过程。

从 @EnableFeignClients 注解可以看到,入口在该注解上的 FeignClientsRegistrar 类上,整个链路是这样的:

Spring Cloud Alibaba Sentinel 整合 Feign 的设计实现

从这个链路上我们可以得到几个信息:

1.@FeignClient 注解修饰的接口最终会被转换成 FeignClientFactoryBean 这个 FactoryBeanFactoryBean内部的 getObject 方法最终会返回一个 Proxy

2.在构造 Proxy 的过程中会根据 org.springframework.cloud.openfeign.Targeter 接口的 target方法去构造。如果启动了hystrix开关(feign.hystrix.enabled=true),会使用 HystrixTargeter,否则使用默认的 DefaultTargeter

3.Targeter 内部构造 Proxy 的过程中会使用 feign.Feign.Builder 去调用它的 build 方法构造 feign.Feign 实例(默认只有一个子类 ReflectiveFeign)。

如果启动了 hystrix 开关(feign.hystrix.enabled=true),会使用 feign.hystrix.HystrixFeign.Builder,否则使用默认的feign.Feign.Builder

4.构造出 feign.Feign 实例之后,调用 newInstance 方法返回一个 Proxy

简单看下这个 newInstance 方法内部的逻辑:

public <T> T newInstance(Target<T> target) {    Map<String, MethodHandler> nameToHandler = targetToHandlersByName.apply(target);    Map<Method, MethodHandler> methodToHandler = new LinkedHashMap<Method, MethodHandler>();    List<DefaultMethodHandler> defaultMethodHandlers = new LinkedList<DefaultMethodHandler>();    for (Method method : target.type().getMethods()) {      if (method.getDeclaringClass() == Object.class) {        continue;      } else if(Util.isDefault(method)) {        DefaultMethodHandler handler = new DefaultMethodHandler(method);        defaultMethodHandlers.add(handler);        methodToHandler.put(method, handler);      } else {        methodToHandler.put(method, nameToHandler.get(Feign.configKey(target.type(), method)));      }    }    // 使用 InvocationHandlerFactory 根据接口的方法信息和 target 对象构造 InvocationHandler    InvocationHandler handler = factory.create(target, methodToHandler);    // 构造代理    T proxy = (T) Proxy.newProxyInstance(target.type().getClassLoader(), new Class<?>[]{target.type()}, handler);    for(DefaultMethodHandler defaultMethodHandler : defaultMethodHandlers) {      defaultMethodHandler.bindTo(proxy);    }    return proxy;  }

这里的 InvocationHandlerFactory 是通过构造 Feign 的时候传入的:

1)使用原生的 DefaultTargeter: 那么会使用 feign.InvocationHandlerFactory.Default 这个 factory,并且构造出来的 InvocationHandlerfeign.ReflectiveFeign.FeignInvocationHandler

2)使用 hystrix 的 HystrixTargeter: 那么会在feign.hystrix.HystrixFeign.Builder#build(feign.hystrix.FallbackFactory) 方法中调用父类的 invocationHandlerFactory方法传入一个匿名的 InvocationHandlerFactory 实现类,该类内部构造出的 InvocationHandlerHystrixInvocationHandler

Sentinel 整合 Feign

理解了 Feign 的执行过程之后,Sentinel 想要整合 Feign,可以参考 Hystrix 的实现:

1.❌ 实现 Targeter 接口 SentinelTargeter。 很不幸,Targeter 这个接口属于包级别的接口,在外部包中无法使用,这个 Targeter 无法使用。没关系,我们可以沿用默认的HystrixTargeter(实际上会用DefaultTargeter,下文 Note 有解释)

2.✅ FeignClientFactoryBean 内部构造 Targeterfeign.Feign.Builder 的时候,都会从 FeignContext 中获取。所以我们沿用默认的 DefaultTargeter 的时候,内部使用的 feign.Feign.Builder 可控,而且这个 Builder 不是包级别的类,可在外部使用

1)创建 SentinelFeign.Builder 继承 feign.Feign.Builder ,用来构造 Feign

2)SentinelFeign.Builder 内部需要获取 FeignClientFactoryBean中的属性进行处理,比如获取 fallback, name, fallbackFactory很不幸,FeignClientFactoryBean 这个类也是包级别的类。没关系,我们知道它存在在 ApplicationContext 中的 beanName, 拿到 bean 之后根据反射获取属性就行(该过程在初始化的时候进行,不会在调用的时候进行,所以不会影响性能)

3)SentinelFeign.Builder 调用 build 方法构造 Feign 的过程中,我们不需要实现一个新的 Feign,跟 hystrix 一样沿用 ReflectiveFeign即可,在沿用的过程中调用父类 feign.Feign.Builder 的一些方法进行改造即可,比如 invocationHandlerFactory 方法设置 InvocationHandlerFactorycontract 的调用

3.✅ 跟 hystrix 一样实现自定义的 InvocationHandler 接口 SentinelInvocationHandler 用来处理方法的调用

4.✅ SentinelInvocationHandler 内部使用 Sentinel 进行保护,这个时候涉及到资源名的获取。SentinelInvocationHandler 内部的 feign.Target 能获取服务名信息,feign.InvocationHandlerFactory.MethodHandler 的实现类 feign.SynchronousMethodHandler 能拿到对应的请求路径信息。

很不幸,feign.SynchronousMethodHandler 这个类也是包级别的类。没关系,我们可以自定义一个 feign.Contract 的实现类SentinelContractHolder 在处理 MethodMetadata 的过程把这些 metadata 保存下来(feign.Contract 这个接口在 Builder 构造 Feign 的过程中会对方法进行解析并验证)。

在 SentinelFeign.Builder 中调用 contract 进行设置,SentinelContractHolder 内部保存一个 Contract 使用委托方式不影响原先的 Contract 过程

Note: spring-cloud-starter-openfeign 依赖内部包含了 feign-hystrix。所以是说默认使用 HystrixTargeter 这个 Targeter ,进入 HystrixTargeter 的 target 方法内部一看,发现有段逻辑这么写的:

@Overridepublic <T> T target(FeignClientFactoryBean factory, Feign.Builder feign, FeignContext context,                    Target.HardCodedTarget<T> target) {  if (!(feign instanceof feign.hystrix.HystrixFeign.Builder)) {    // 如果 Builder 不是 feign.hystrix.HystrixFeign.Builder,使用这个 Builder 进行处理    // 我们默认构造了 SentinelFeign.Builder 这个 Builder,默认使用 feign-hystrix 依赖也没有什么问题    return feign.target(target);  }  feign.hystrix.HystrixFeign.Builder builder = (feign.hystrix.HystrixFeign.Builder) feign;  ...}

在 SentinelInvocationHandler 内部我们对资源名的处理策略是: http方法:protocol://服务名/请求路径跟参数

比如这个 TestService:

@FeignClient(name = "test-service")public interface TestService {  @RequestMapping(value = "/echo/{str}", method = RequestMethod.GET)  String echo(@PathVariable("str") String str);  @RequestMapping(value = "/divide", method = RequestMethod.GET)  String divide(@RequestParam("a") Integer a, @RequestParam("b") Integer b);}
  • echo 方法对应的资源名:GET:http://test-service/echo/{str}

  • divide 方法对应的资源名:GET:http://test-service/divide

总结

1.Feign 的内部很多类都是 package 级别的,外部 package 无法引用某些类,这个时候只能想办法绕过去,比如使用反射

2.目前这种实现有风险,万一哪天 starter 内部使用的 Feign 相关类变成了 package 级别,那么会改造代码。所以把 Sentinel 的实现放到 Feign 里并给 Feign 官方提 pr 可能更加合适

3.Feign的处理流程还是比较清晰的,只要能够理解其设计原理,我们就能容易地整合进去

欢迎大家对整合方案进行讨论,并能给出不合理的地方,当然能提pr解决不合理的地方就更好了。

Sentinel Starter 整合 Feign 的代码目前已经在 github 仓库上,但是没未发版。预计月底发版,如果现在就想使用,可以在 pom 中引入 Spring SNAPSHOT 的 repository 或自行下载源码进行编译。

最后再附上一个使用 Nacos 做服务发现和 Sentinel 做限流的 Feign 例子。

https://github.com/spring-cloud-incubator/spring-cloud-alibaba/tree/master/spring-cloud-alibaba-examples/nacos-example/nacos-discovery-example

最近干货分享

Spring Boot 返回 JSON 数据,一分钟搞定!

用 Git 和 Github 提高效率的 10 个技巧!

面试常考:Synchronized 有几种用法?

Java 11 已发布,String 还能这样玩!

Hashtable 为什么不叫 HashTable?

Spring Cloud Alibaba Sentinel 整合 Feign 的设计实现

本文分享自微信公众号 - Java技术栈(javastack)。
如有侵权,请联系 support@oschina.cn 删除。
本文参与“OSC源创计划”,欢迎正在阅读的你也加入,一起分享。

点赞
收藏
评论区
推荐文章
blmius blmius
3年前
MySQL:[Err] 1292 - Incorrect datetime value: ‘0000-00-00 00:00:00‘ for column ‘CREATE_TIME‘ at row 1
文章目录问题用navicat导入数据时,报错:原因这是因为当前的MySQL不支持datetime为0的情况。解决修改sql\mode:sql\mode:SQLMode定义了MySQL应支持的SQL语法、数据校验等,这样可以更容易地在不同的环境中使用MySQL。全局s
皕杰报表之UUID
​在我们用皕杰报表工具设计填报报表时,如何在新增行里自动增加id呢?能新增整数排序id吗?目前可以在新增行里自动增加id,但只能用uuid函数增加UUID编码,不能新增整数排序id。uuid函数说明:获取一个UUID,可以在填报表中用来创建数据ID语法:uuid()或uuid(sep)参数说明:sep布尔值,生成的uuid中是否包含分隔符'',缺省为
待兔 待兔
3个月前
手写Java HashMap源码
HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程HashMap的使用教程22
Jacquelyn38 Jacquelyn38
3年前
2020年前端实用代码段,为你的工作保驾护航
有空的时候,自己总结了几个代码段,在开发中也经常使用,谢谢。1、使用解构获取json数据let jsonData  id: 1,status: "OK",data: 'a', 'b';let  id, status, data: number   jsonData;console.log(id, status, number )
Wesley13 Wesley13
2年前
mysql设置时区
mysql设置时区mysql\_query("SETtime\_zone'8:00'")ordie('时区设置失败,请联系管理员!');中国在东8区所以加8方法二:selectcount(user\_id)asdevice,CONVERT\_TZ(FROM\_UNIXTIME(reg\_time),'08:00','0
Wesley13 Wesley13
2年前
00:Java简单了解
浅谈Java之概述Java是SUN(StanfordUniversityNetwork),斯坦福大学网络公司)1995年推出的一门高级编程语言。Java是一种面向Internet的编程语言。随着Java技术在web方面的不断成熟,已经成为Web应用程序的首选开发语言。Java是简单易学,完全面向对象,安全可靠,与平台无关的编程语言。
Stella981 Stella981
2年前
Django中Admin中的一些参数配置
设置在列表中显示的字段,id为django模型默认的主键list_display('id','name','sex','profession','email','qq','phone','status','create_time')设置在列表可编辑字段list_editable
Wesley13 Wesley13
2年前
MySQL部分从库上面因为大量的临时表tmp_table造成慢查询
背景描述Time:20190124T00:08:14.70572408:00User@Host:@Id:Schema:sentrymetaLast_errno:0Killed:0Query_time:0.315758Lock_
为什么mysql不推荐使用雪花ID作为主键
作者:毛辰飞背景在mysql中设计表的时候,mysql官方推荐不要使用uuid或者不连续不重复的雪花id(long形且唯一),而是推荐连续自增的主键id,官方的推荐是auto_increment,那么为什么不建议采用uuid,使用uuid究
Python进阶者 Python进阶者
8个月前
Excel中这日期老是出来00:00:00,怎么用Pandas把这个去除
大家好,我是皮皮。一、前言前几天在Python白银交流群【上海新年人】问了一个Pandas数据筛选的问题。问题如下:这日期老是出来00:00:00,怎么把这个去除。二、实现过程后来【论草莓如何成为冻干莓】给了一个思路和代码如下:pd.toexcel之前把这