【Spring Cloud】详解Feign常用配置

1 Feign常用配置

搭载着Spring Cloud的顺风车,Feign正以席卷之势成为使用Spring架构的大大小小互联网公司发起HTTP调用的首选框架。基于接口的声明式定义、客户端负载均衡、断路器和后备方法(fallback)是Feign相对上一代HTTP调用框架(比如Spring Template,Apache HttpClient)的四大优势。

类似于Retrofit和OkHttp的关系,Feign实际上是对普通HTTP客户端的一层封装,其目的是降低集成成本、提升可靠性。Feign支持三种HTTP客户端,包括JDK自带的HttpURLConnection、Apache HttpClient和Square OkHttp,默认使用Apache HttpClient。

feign.okhttp.enabled=true

Feign提供了两大类配置属性来配置上述三种HTTP客户端, feign.client.*feign.httpclient.* ,前者支持按实例进行配置(注解-1),后者全局共享一套配置,包含线程池配置,但只影响HttpClient和OkHttp,不影响HttpURLConnection,具体关系见下表。

注解-1:所谓按实例进行配置,就是指每个FeignClient实例都可以通过 feign.client.<feignClientName>.* 来单独进行配置,注意首字母小写。而 feign.client.default.* 表示默认配置。

HTTP客户端 连接超时时间 请求超时时间 线程存活时间 线程池最大连接数(全局) 线程池最大连接数(单个HOST)
HttpURLConnection feign.client. [default|<feignClientName>].connect-timeout <br/>默认值:10秒 feign.client. [default|<feignClientName>].read-timeout <br/>默认值:60秒 N/A N/A N/A
HttpClient feign.httpclient.connection-timeout<br/>默认值:2秒 默认值:-1(RequestConfig.Builder.socketTimeout) feign.httpclient.time-to-live<br/>默认值:900秒 feign.httpclient.max-connections<br/>默认值:200 feign.httpclient.max-connections-per-route<br/>默认值:50
OkHttp feign.httpclient.connection-timeout<br/>默认值:2秒 feign.client. [default|<feignClientName>].read-timeout <br/>默认值:10秒 feign.httpclient.time-to-live<br/>默认值:900秒 feign.httpclient.max-connections<br/>默认值:200 N/A

从上表可以看到,Feign提供了两个连接超时配置,HttpURLConnection使用 feign.client.[default|<feignClientName>].connect-timeout ,而HttpClient和OkHttp则使用 feign.httpclient.connection-timeout ,这一点要尤其注意。

2 启用Hystrix

通过设置 feign.hystrix.enabled=true 可以启用Feign的断路器支持(基于Hystrix)。跟Feign一样,Hystrix也支持按实例进行配置,详细配置属性参见 官方文档 。

由于Hystrix默认的请求超时时间为1秒,很容易触发超时异常,所以往往需要调大。调大超时时间有两种方式,

  • 第一种方式,通过 hystrix.command.default.execution.isolation.thread.timeoutInMilliseconds 设置默认超时时间,影响所有请求。
  • 第二种方式,如果你不想改变所有请求的超时时间,那么可以通过 hystrix.command.<HystrixCommandKey>.execution.isolation.thread.timeoutInMilliseconds 单独设置某个Hystrix Command的超时时间。那么问题来了,Feign下面,这个Hystrix Command Key到底是什么呢,是和Feign Client Name一样吗?答案是否定的。Feign下面,一个Hystrix Command对应的是Feign Client的一个方法,因此Hystrix Command Key的定义为 <FeignClientName>#<methodName>(<arg1ClassName>,<arg2ClassName>...) ,注意首字母大写,详见 SetterFactory.Default#create() 方法。

3 小结

不管是Spring还是Spring Cloud,由于整个生态过于庞大,因此即便是官方文档,也只能勉强覆盖各个组件的大体框架,一旦深入细节就只能靠开发者自己研读源码来寻找答案。就像Linus Torvalds说的, Talk is cheap. Show me the code.

【Spring Cloud】详解Feign常用配置

4 参考

  • Spring Cloud OpenFeign
  • Spring cloud Feign 深度学习与应用
  • Spring Cloud组件那么多超时设置,如何理解和运用?

原文 

https://segmentfault.com/a/1190000022106957

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » 【Spring Cloud】详解Feign常用配置

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址