【Spring Cloud系列】Feign详解与实战

这篇具有很好参考价值的文章主要介绍了【Spring Cloud系列】Feign详解与实战。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

Feign详解与实战

一、概述

在前一章介绍了Ribbon的用法,在使用Ribbon是通过RestTemplate调用其他服务的API时,所有参数必须在请求的URL中进行拼接。如果参数过多,拼接请求字符串会导致效率下降。Spring Cloud提供另外一种调用API的解决方案,既使用Spring Cloud Feign

二、什么是Feign

Feign是一种负载均衡的HTTP客户端,它封装了Ribbon。使用Feign调用API就像调用本地方法一样。从而避免了调用微服务时,需要不断封装/解析Json数据的繁琐步骤。

Feign是一个声明似的Web客户端,它使得编写Web服务客户端变得更容易。使用Fegin创建一个接口并对它进行注解。它具有可插拔的注解支持包含Fegin注解与JAX-RS注解,Feign还支持可插拔的编码器与解码器,Spirng Cloud增加了对Spring MVC的注解功能。Feign默认集成了Ribbon,所以Fegin默认就实现了负载均衡效果。

三、Feign特性

  • 支持可插拔的HTTP编码器和解码器
  • 支持Hystrix和它的Fallback;
  • 支持Ribbon的负载均衡;
  • 支持HTTP请求和响应的压缩。

四、Feign简单使用

3.1 Feign使用步骤

  1. 引入依赖
  2. 在启动类上添加注解
  3. 编写FeignClient接口
  4. 使用Feign发起http请求
  5. 配置Feign日志

3.2 Feign具体使用

1. 引入依赖
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
2. 启动类上添加注解
@MapperScan("com.goyeer")
@SpringBootApplication
@EnableFeignClients
public class GoyeerApplication {

    public static void main(String[] args) {
        SpringApplication.run(OrderApplication.class, args);
    }
}

3.编写FeignClient接口
@FeignClient("orderservice")
public interface OrderClient {
    @GetMapping("/Order/findById")
    Order findById(@PathVariable("orderId") Long orderId);
}

五、使用Feign发起http请求

5.1 Maven导入Feign配置,并集成Jackson

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<!-- 用于解析数据 -->
<dependency>
    <groupId>io.github.openfeign</groupId>
    <artifactId>feign-jackson</artifactId>
    <version>9.7.0</version>
</dependency>

5.2 Feign发送路径和方法设置

@RequestLine("GET /user/getone?arkOrgId={arkOrgId}&userId={userId}")
JSONObject getOneEmployee(@Param("orgId") String orgId,@Param("userId") String userId);

@RequestLine("POST /user/add")
@Headers("Content-Type: application/json")
@Body("{body}")
JSONObject saveEmployee(@Param("body") EmployeeDTO employeeDTO);

5.3 调用Feign.bulider()指定请求uri并且调用接口中的方法

public class App{
    public static void main(String[] args){
        EmloyeeAPI emloyeeAPI = Feign.builder().target(EmloyeeAPI.class,"http://localhost:8088");
        String result = emloyeeAPI.getOneEmployee("110","1110");
        System.out.println(result);
    }
}

六、Feign接口常用注解

注解 类型 说明
@RequestLine Method 定义其请求方法和请求路径(UriTemplate)。请求路径以斜杠开始,中间可以使用{变量名称},表达式的值由@Param注解提供。
@Param Parameter 定义变量模板,可通过表达式{变量名称}引用变量的值
@Headers Method,Type 定义请求头,可以使用{变量名},表达式的值由@Param注解提供。
@QueryMap Parameter 定义Map或者Pojo类型参数。
@HeaderMap Parameter 定义Map类型的请求头
@Body Method 对@Param扩展,配合@Headers使用可定义JSON、XML类型参数

七、Feign接口与常用注解

7.1 target方法

指定接口类型和URL地址接口Http代理对象,从而通过代理对象调用方法发送HTTP请求。

7.2 client方法

Feign在默认情况下使用的是JDK原生的URLConnection发送HTTP请求。

7.3 options方法

指定连接超时时长及响应超时时长,单位毫秒。

7.4 retryer方法

指定重试策略,参数分别是最小时间,最大时间,重连次数。

7.5 encoder()/decode()方法

指定编码/解码方式默认是String

7.6 logger() logLevel()

指定日志和日志等级、可配置SLF4J等

7.7 @EnableFeignClients

用来开启Feign

7.8 @FeignClient

标记要用Feign来拦截的请求接口

7.9 value,name

value 和 name 的作用一样,如果没有配置url那么配置的值将作为服务名称,用于服务发现。反之只是一个名称。

7.10 serviceId

serviceId已经废弃了,直接使用name即可。

7.11 contextId

解决Bean的名称冲突了。

7.12 url

url用于配置指定服务的地址,相当于直接请求这个服务,不经过Ribbon的服务选择。像调试等场景可以使用。

7.13 decode404

当调用请求发生404错误时,decode404的值为true,那么会执行decoder解码,否则抛出异常。

7.14 configuration

configuration是配置Feign配置类,在配置类中可以自定义Feign的Encoder、Decoder、LogLevel、Contract等。

7.15 fallback

定义容错的处理类,也就是回退逻辑,fallback的类必须实现Feign Client的接口,无法知道熔断的异常信息。

7.16 fallbackFactory

也是容错的处理,可以知道熔断的异常信息。

7.17 path

path定义当前FeignClient访问接口时的统一前缀,比如接口地址是/user/get, 如果你定义了前缀是user, 那么具体方法上的路径就只需要写/get 即可。

7.18 primary

primary对应的是 @Primary 注解,默认为 true,官方这样设置也是有原因的。当我们的Feign实现了fallback后,也就意味着Feign Client有多个相同的Bean在Spring容器中,当我们在使用@Autowired进行注入的时候,不知道注入哪个,所以我们需要设置一个优先级高的,@Primary 注解就是干这件事情的。

7.19 qualifier

qualifier 对应的是 @Qualifier 注解,使用场景跟上面的primary关系很淡,一般场景直接 @Autowired 直接注入就可以了。

八、Feign的日志级别

8.1 Feign的日志级别

  • NONE(默认):不记录任何日志,性能最佳,使用与生产环境。
  • BASIC:仅记录请求方法,URL、响应状态代码以及执行时间,适用于生产环境追踪问题;
  • HEADERS:在BASIC级别的基础上,记录请求和响应的Header;
  • FULL:记录请求和响应的Header\Body和元数据,使用于开发测试定位问题。

8.2 Feign日志配置方法

  • 配置类全局配置

    在工程中增加一个配置类、如下设定日志级别,可作为全局配置

    @Configuration
    public class FeignConfig{
        @Bean
        public Logger.Level level(){
            return Logger.level.FULL;
        }
    }
    
  • 配置类局部配置

    首先将FeignConfig的@Configuration注解去掉,否则将是全局配置。

    在@FeignClient中configuration属性赋值为FeignConfig.class

    @FeignClient(path = "/employee", value = "provider", configuration = FeignConfig.class)
    public interface UserService {
        @RequestMapping("/list")
        List<String> findEmployee();
    }
    
  • 配置文件指定微服务配置

    在配置文件中,加入如下配置,provider为服务端服务名,改配置只对调用provider服务时生效。

    feign.client.config.provider.loggerLevel=BASIC
    

九、Feign原理

4.1 Feign服务调用的工作原理可以总结为以下几个步骤:

  1. 首先通过@EnableFeignCleints注解开启FeignCleint。
  2. 根据Feign的规则实现接口,添加@FeignCleint注解。程序启动后,会扫描所有有@FeignCleint的类,并将这些信息注入到ioc容器中。
  3. 注入时从FeignClientFactoryBean.class获取FeignClient。
  4. 当接口的方法被调用时,通过jdk的代理,来生成具体的RequesTemplate,RequesTemplate生成http的Reques。
  5. Request交给Client去处理,其中Client可以是HttpUrlConnection、HttpClient也可以是Okhttp。
  6. Client被封装到LoadBalanceClient类,这个类结合类Ribbon做到了负载均衡。

4.2 Feign整体流程图

【Spring Cloud系列】Feign详解与实战,Spring Cloud,spring cloud,spring,后端

十、Feign与Ribbon异同

Ribbon与Feign都是实现负载均衡的组件,Feign的本质是Ribbon,是基于Ribbon的实现。都是加在消费端的注解,让消费端可以调用其他生产者的服务。

Fegin与Ribbon的两者的区别

  • 启动类使用的注解不同,Ribbon用的是@RibbonClinet,Feign用的是@EnableFeignClients。
  • 服务的指定位置不同,Ribbon 是在@RibbonClient 注解上声明,Feign 则是在定义抽象方法的接口中使用@FeignClient 声明。
  • 调用方式不同,Ribbon 需要自己构建 http 请求,模拟 http 请求然后使用 RestTemplate 发送给其他服务,步骤相当繁琐。
  • Ribbon可配置负载均衡机制

十一、Feign与RestTemplate异同

  • RestTemplate

    RestTemplate 是从 Spring3.0 开始支持的一个 HTTP 请求工具,它提供了常见的REST请求方案的模版,例如 GET 请求、POST 请求、PUT 请求、DELETE 请求以及一些通用的请求执行方法 exchange 以及 execute。RestTemplate 继承自 InterceptingHttpAccessor 并且实现了 RestOperations 接口,其中 RestOperations 接口定义了基本的 RESTful 操作,这些操作在 RestTemplate 中都得到了实现。

    1. 添加相关注解参数即可,使用简单方便。
    2. 熔断节点易控制,方便后续基于业务作出相应调整。
    3. 异常捕获简单,同页面下添加对应方法即可。
    4. 请求更贴近httpclient,使用更有熟悉感。
    5. 灵活性高但是消息封装臃肿。
  • Feign

    一种负载均衡的HTTP客户端, 使用Feign调用API就像调用本地方法一样,从避免了 调用目标微服务时,需要不断的解析/封装json 数据的繁琐。Feign是一个声明似的web服务客户端,Spring Cloud 增加了对 Spring MVC的注解,Spring Web 默认使用了HttpMessageConverters, Spring Cloud 集成 Ribbon 和 Eureka 提供的负载均衡的HTTP客户端 Feign。文章来源地址https://www.toymoban.com/news/detail-727532.html

    1. 编写方式优雅,基于面向接口的风格,但是开发起来较为繁琐。
    2. yml需要添加配置启动hystrix组件。
    3. 需要创建对应类来执行fallback方法。
    4. 捕获异常信息和不捕获异常实现的接口不同。
    5. 需要在feign注解上作出相应参数配置。
    6. feign中作出任何操作需要创建各种类来对应不同参数

十二、Feign和OpenFeign异同

  • 相同点

    1. Feign 和 OpenFeign 都是 Spring Cloud 下的远程调用和负载均衡组件。
    2. Feign 和 OpenFeign 作用一样,都可以实现服务的远程调用和负载均衡。
    3. Feign 和 OpenFeign 都对 Ribbon 进行了集成,都利用 Ribbon 维护了可用服务清单,并通过 Ribbon 实现了客户端的负载均衡。
    4. Feign 和 OpenFeign 都是在服务消费者(客户端)定义服务绑定接口并通过注解的方式进行配置,以实现远程服务的调用。
  • 不同点

    1. Feign 和 OpenFeign 的依赖项不同,Feign 的依赖为 spring-cloud-starter-feign,而 OpenFeign 的依赖为 spring-cloud-starter-openfeign。
    2. Feign 和 OpenFeign 支持的注解不同,Feign 支持 Feign 注解和 JAX-RS 注解,但不支持 Spring MVC 注解;OpenFeign 除了支持 Feign 注解和 JAX-RS 注解外,还支持 Spring MVC 注解

到了这里,关于【Spring Cloud系列】Feign详解与实战的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 实战系列(一)| Dubbo和Spring Cloud的区别,包含代码详解

    Dubbo 和 Spring Cloud 都是微服务架构中的重要框架,但它们的定位和关注点不同。Dubbo 是阿里巴巴开源的一个高性能、轻量级的 RPC 框架,主要用于构建微服务之间的服务治理。而 Spring Cloud 是基于 Spring Boot 的一个微服务架构开发工具,它提供了一系列的开发工具和服务,帮助开

    2024年02月10日
    浏览(36)
  • Spring Cloud Feign实战来袭:工程中配置断路器Hystrix报错NoClassDefFoundError:HystrixCommandAspect解决方案

    在Spring Cloud Feign工程中配置断路器Hystrix的时候,pom.xml文件已经加入Hystrix相关的jar: Application.java: 可以看出来是找不到HystrixCommandAspec.java这个类,于是在github上找到这个源文件: https://github.com/dmgcodevil/Hystrix/blob/958ec5d7b4bb967be077a4c2bbcdc71e7a7f5248/hystrix-contrib/hystrix-javanica/src/mai

    2024年02月16日
    浏览(46)
  • Spring Cloud Feign MultipartFile文件上传踩坑之路(包含前端文件上传请求、后端文件保存到aliyun-oss文件服务器)

    文件上传组件用的是ant-design的a-upload组件,我的界面如下所示: 文件上传请求API: FileUtils.js 需要注意的只有FileUtils.js定义的uploadApi请求函数,其中 URL 为后端请求接口(“/imageConvert/upload”),文件上传方法必须定义为 POST ,在 headers 加入’Content-type’: ‘multipart/form-data’,后端

    2024年02月12日
    浏览(46)
  • 19套项目实战系列--Spring Cloud Spring Boot(整套源码)

    整套大型项目源码,需要的回复私信:19 ┃ ┃ ┃ ┣━1-3 项目微服务架构图【课前必知】.vep ┃ ┃ ┃ ┣━1-4 项目技术架构图【课前必知】.vep ┃ ┃ ┃ ┣━10-1 接口解耦需求【章节概述】.vep ┃ ┃ ┃ ┣━10-12 实现文章的定时延迟发布【延迟队列】.vep ┃ ┃ ┃ ┣━10-2 Rabb

    2024年02月15日
    浏览(87)
  • 【Spring Cloud系列】Hystrix应用详解

    在一个分布式系统中,每个服务都可能会调用其它的服务器,服务之间是相互调用相互依赖。假如微服务A调用微服务B和微服务C,微服务B和微服务C又调用其他的微服务。这就是构成所谓“扇出”。 如果扇出的链路上某个微服务的调用响应的时间过长或者不可用,对微服A的调

    2024年02月16日
    浏览(54)
  • 【Spring Cloud系列】- Eureka使用详解

    Eureka2.0版本已经停止维护,为什么要写这篇博客重复已停止更新的中间件,其目的主要是: 认识微服务注册中心:虽然Eureka已经停止维护,但微服务架构在当今非常流程,学习Eureka可以更好的理解微服务。 便于老旧系统维护:如果使用微服务,公司一定会存在使用Eureka服务

    2024年02月09日
    浏览(48)
  • 【Spring Cloud系列】- RestTemplate使用详解

    RestTemplate是Spring框架提供用于调用Rest接口的一个应用,它简化了与http服务通信方式。RestTemplate统一Restfull调用的标准,封装HTTP链接,只要需提供URL及返回值类型即可完成调用。相比传统的HttpClient与Okhttp,RestTemplate是一种优雅,简洁调用RESTfull服务的方式。 RestTemplate默认依赖

    2024年02月08日
    浏览(49)
  • 【Spring Cloud】如何使用Feign实现远程调用

    本次示例代码的文件结构如下图所示。 在 order-service 的 pom.xml 文件中导入 Feign 的依赖坐标。 在 order-service 的启动类上添加注解 @EnableFeignClients ,以开启 Feign 功能。 Feign 采用了 Spring MVC 的注解的方式发起远程调用。只需要把发 HTTP 请求的信息声明在一个接口中,并添加注解

    2024年02月13日
    浏览(45)
  • Spring Cloud 实战系列之 Zuul 微服务网关搭建及配置

    用mavan搭建也可以。(重要的是后面pom里应该引入那些依赖,application.yml怎么配置) 由于开始构建项目时选择了Eureka Server,所以pom.xml中不需要手动添加依赖了 首先在启动类SpringcloudApplication中添加EurekaServer的注解:@EnableEurekaServer 访问注册中心:按照配置的端口号访问。我这

    2024年03月10日
    浏览(41)
  • 【Spring Cloud系列】-Eureka服务端高可用详解

    上一篇《Eureka使用详解》一文中我们详细介绍了什么是Spring Cloud微服务。Spring Cloud中Service注册中心及其Client如何实现并如何完成服务注册的。这一篇我们将介绍Eureka注册中心的高可用如何实现及其使用中的注意事项。 一. 序言 微服务就是开发一组小型服务的方式来完成对系

    2024年02月09日
    浏览(63)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包