04-Feign组件(替代Ribbon)

Feign组件(替代Ribbon)

什么是Feign

Feign是Netflix开发的声明式,模板化的HTTP客户端,其灵感来自RetrofitJAXRS 2.0以及WebSocket

  • Feign 可以帮助我们更快捷、优雅地调用HTTP API

  • Feign 是在 Ribbon 的基础上进行了一次改进,内部支持负载均衡 只需要创建一个接口类,然后在类上面添加注解 ,将需要调用的其他服务的方法定义成抽象方法即可, 不需要自己构建 http 请求。然后就像是调用自身工程的方法一样调用,而感觉不到是调用远程方法,使得编写 客户端变得非常容易。

入门搭建

引入坐标

<!--springcloud整合的openFeign-->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

配置调用接口

/**
 * 声明需要调用的微服务名称
 *
 * 注解:@FeignClient
 *        name:服务提供者的服务名称
 * 		@FeignClient 注解通过name指定需要调用的微服务的名称,用于创建Ribbon的负载均衡器,
 * 				所以Ribbon会把 service-product 解析为注册中心的服务。
 **/
@FeignClient(name = "service-product")
public interface ProductFeignClient {

   /**
	 * 配置需要调用的微服务接口
	 * 此处的url为:提供者controller方法的具体url
	 */
	@RequestMapping(value = "/product/{id}", method = RequestMethod.GET)
	Product findById(@PathVariable("id") Long id);

}

在启动类上 激活Fegin

@SpringBootApplication
@EnableFeignClients	//激活Feign
public class OrderServiceApplication {
    ...
}

通过自己的接口调用远程微服务

@RestController
@RequestMapping(value = "/order")
public class OrderController {

	@Autowired
	private ProductFeignClient productFeignClient;//注入Feign接口

	@RequestMapping(value = "/buy/{id}", method = RequestMethod.GET)
	public Product findByIdFunTwo(@PathVariable Long id) {
		Product product = productFeignClient.findById(id);
		return product;
	}
}

Feign高级

Feign的配置

从Spring Cloud Edgware开始,Feign支持使用属性自定义Feign。对于一个指定名称的Feign Client(例如该Feign Client的名称为 feignName ),Feign支持如下配置项:

feign: 
	client: 
	config: 
		feignName: ##定义FeginClient的名称 
        connectTimeout: 5000 # 相当于Request.Options 
        readTimeout: 5000 # 相当于Request.Options 
        # 配置Feign的日志级别,相当于代码配置方式中的Logger 
        loggerLevel: full # Feign的错误解码器,相当于代码配置方式中的ErrorDecoder 
        errorDecoder: com.example.SimpleErrorDecoder # 配置重试,相当于代码配置方式中的Retryer 
        retryer: com.example.SimpleRetryer # 配置拦截器,相当于代码配置方式中的RequestInterceptor 
        requestInterceptors: 
        - com.example.FooRequestInterceptor 
        - com.example.BarRequestInterceptor decode404: false

参数解释

  • feignName:FeginClient的名称

  • connectTimeout : 建立链接的超时时长

  • readTimeout : 读取超时时长

  • loggerLevel: Fegin的日志级别

  • errorDecoder :Feign的错误解码器

  • retryer : 配置重试

  • requestInterceptors : 添加请求拦截器

  • decode404 : 配置熔断不处理404异常

请求压缩

Spring Cloud Feign 支持对请求和响应进行GZIP压缩,以减少通信过程中的性能损耗。通过下面的参数即可开启请求与响应的压缩功能:

feign: 
    compression: 
    	request: 
    		enabled: true # 开启请求压缩 
    	response: 
    		enabled: true # 开启响应压缩

同时,我们也可以对请求的数据类型,以及触发压缩的大小下限进行设置:

feign: 
    compression: 
        request: 
            enabled: true # 开启请求压缩 
            mime-types: text/html,application/xml,application/json # 设置压缩的数据类型 
            min-request-size: 2048 # 设置触发压缩的大小下限

日志级别

在开发或者运行阶段往往希望看到Feign请求过程的日志记录,默认情况下Feign的日志是没有开启的。要想用属性配置方式来达到日志效果,只需在 application.yml 中添加如下内容即可:

#配置feign日志的输出
feign:
  client:
    config:
      server-product:  #需要调用的服务名称
        loggerLevel: FULL
logging:
  level:
    com.hwx.order.feign.ProductFeignClient: debug  #打印接口的日志,接口的全类名路径
  • logging.level.xx : debug : Feign日志只会对日志级别为debug的做出响应

  • feign.client.config.server-product.loggerLevel : 配置Feign的日志Feign有四种日志级别:

    • NONE【性能最佳,适用于生产】:不记录任何日志(默认值)

    • BASIC【适用于生产环境追踪问题】:仅记录请求方法、URL、响应状态代码以及执行时间

    • HEADERS:记录BASIC级别的基础上,记录请求和响应的header。

    • FULL:【比较适用于开发及测试环境定位问题】:记录请求和响应的header、body和元数

4-1

Feign和Ribbon的区别

  1. Ribbon是一个客户端的负载均衡器
  2. Feign是在Ribbon的基础上进行了封装

源码分析

4-2

posted @ 2021-07-19 15:42  爱码士很优秀  阅读(295)  评论(0)    收藏  举报