初识Spring Cloud系列——Feign原理

780 阅读3分钟

这是我参与更文挑战的第19天,活动详情查看: 更文挑战

说到Feign,我们想到的功能就是微服务之间的调用,其作用与相当于之前使用RestTemplate实现Http调用

Feign有哪些?

feign、openfeign、spring-cloud-openfeign三者都是Feign

区别与联系

feign 和 openfeign

参考网站 "Netflix feign" is the old project designation. The last version (dependency below) is dated July 2016.

compile group: 'com.netflix.feign', name: 'feign-core', version:'8.18.0' // OLD "Open feign" is the new project designation. It's the same project, but was moved to a different git repo and got a new group-id. Its versions start at 9.0.0.

Netflix 公司不再维护feign,feign由社区维护,feign更名为 openfeign,最后一个版本是8.18.0,并且项目迁移到新的仓库。在9.0.0之后的版本仅使用 “io.github.openfeign”,推荐使用该依赖

Feign是Spring Cloud组件中的一个轻量级RESTful的HTTP服务客户端Feign内置了Ribbon,用来做客户端负载均衡,去调用服务注册中心的服务。 OpenFeign是Spring Cloud在Feign的基础上支持了SpringMVC的注解,如@RequesMapping等等。

spring-cloud-openfeign 和 openfeign 有什么关系?

spring-cloud-openfeign 是基于 openfeign 进行包装,集成了 SpringMVC 的注解等方便SpringBoot项目开发的一个组件。

为什么要用Feign?

Feign应用于一个接口会被多处调用的情况,针对每个微服务自行封装一些客户端类来包装这些依赖服务的调用。Feign在此基础上做了进一步封装,由他来帮助我们定义和实现依赖服务接口的定义。 在Feign的实现下,只需创建一个接口并使用注解的方式来配置它,就能够完成对服务提供方的接口绑定,同时,Feign集成了Ribbon,因此使用Feign简化了使用Spring cloud Ribbon时,自动封装服务调用客户端的开发量

openfeign的使用

创建一个feign模块

导入相关依赖

 <dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-OpenFopenfeign</artifactId>
</dependency>

在业务层接口加入注解@FeignClient

比如:

@Component
@FeignClient(value = "CLOUD-User-SERVICE")
public interface UserFeignService
{
    @GetMapping(value = "/user/get/{id}")
    public CommonResult<User> getUserById(@PathVariable("id") Long id);

}

@FeignClient标签的常用属性如下:

  • name:指定FeignClient的名称,如果项目使用了Ribbon,name属性会作为微服务的名称,用于服务发现
  • url: url一般用于调试,可以手动指定@FeignClient调用的地址
  • decode404:当发生http 404错误时,如果该字段位true,会调用decoder进行解码,否则抛出FeignException
  • configuration: Feign配置类,可以自定义Feign的Encoder、Decoder、LogLevel、Contract
  • fallback: 定义容错的处理类,当调用远程接口失败或超时时,会调用对应接口的容错逻辑,fallback指定的类必须实现@FeignClient标记的接口
  • fallbackFactory: 工厂类,用于生成fallback类示例,通过这个属性我们可以实现每个接口通用的容错逻辑,减少重复的代码
  • path: 定义当前FeignClient的统一前缀

OpenFeign日志增强

日志打印功能

Feign提供了日志打印功能,我们可以通过配置来调整日恙级别,从而了解Feign 接口中 Http请求的细节。

日志级别

  • NONE:默认的,不显示任何日志;
  • BASIC:仅记录请求方法、URL、响应状态码及执行时间;
  • HEADERS:除了BASIC中定义的信息之外,还有请求和响应的头信息;
  • FULL:除了HEADERS中定义的信息之外,还有请求和响应的正文及元数据。

今日小结 今天大致了解了下 openfeign的作用以及对它的使用