生命太短暂，不要去做一些根本没有人想要的东西。本文已被 https://www.yourbatman.cn 收录，里面一并有Spring技术栈、MyBatis、JVM、中间件等小而美的专栏供以免费学习。关注公众号【BAT的乌托邦】逐个击破，深入掌握，拒绝浅尝辄止。

本专栏所有文章均计划逐步重写搬迁至本人公号：Java方向盘，且免费开放！故不再建议下单购买，可关注我公号前往免费学习、交流

–> 返回Netflix OSS套件专栏汇总 <–
代码下载地址：https://github.com/f641385712/feign-learning

目录

    • 前言
      • 版本声明
    • 正文
      • 官网介绍
        • 产品原理图
        • 产品路线图
          • 短期：目前正在做的
          • 中期：下一步会做的
          • 长期：将来会做的
        • 为何选择Feign而非其它？
        • Feign是如何工作的？
        • 对Java版本的兼容性
        • 相关模块
      • 使用示例
      • Netflix Feign还是Open Feign？
        • spring-cloud-starter-feign还是spring-cloud-starter-openfeign？
    • 总结
  • 关注A哥

前言

各位小伙伴大家好，我是A哥。从本系列开始，我们将一起进入Netflix Feign的学习。说到HTTP客户端，大家都不会感到陌生。Java自己源生的就有java.net包下的HttpURLConnection（虽然不太好用），同时优秀的开源产品更是百花齐放：

  • Apache HttpClient
  • OkHttp
  • Spring的RestTemplate
    • 说明：它基于以上三种Client做的包装
  • Feign（本专栏详述）

Feign的中文意思：假装；装作；捏造；想象

JDK源生的HC偏于底层且不好用，在Java9之前你几乎可以忽略它；作为老牌的Apache HttpClient凭借着各种优秀特征，似乎已成为了事实的标准；后起之秀OkHttp有着低网络延迟、更优秀的连接池性能，亦是一股不可轻视的力量；Spring它自己并不去重复发明轮子，而是借力打力提供了Http统一调用方式RestTemplate，屏蔽了细节，规范了开发者的使用。

说明：如果你在Spring环境，并不建议直接使用具体的HttpCLient技术，而是使用面向中间语言的RestTemplate。

本专栏将介绍一种 声明式 Http客户端：Feign。很多人认识Feign、使用Feign是因为Spring Cloud，它作为Spring Cloud最重要的组件之一，深入了解Feign对我们在云计算领域实践将具有很强的实战意义。
本专栏追本溯源，从最源生的Feign出发，再到和Spring整合、和Spring Boot整合，最后到Spring Cloud上的应用。目的是让你“一文在手，说走就走”。

版本声明

本专栏使用的各库的版本号做出如下声明：

  • Feign版本号：10.4.0
  • Spring版本号：5.2.2.RELEASE
  • Spring Boot版本号：2.2.2.RELEASE
    • 基于Spring5.2.2.RELEASE构建的
  • Spring Cloud版本号：Hoxton.SR1
    • 要求的Spring Boot 2.2.0版本以上（所以请确保和Spring Boot刚好搭配使用）

说明：Feign选择10.4.0版本，是为了保持和最新的SC的Hoxton.SR1版本“携带”的版本号保持一致。

feign-xxx模块附带的版本号公示（括号内为当前最新版本）：

  • feign-okhttp -> okhttp 3.6.0（3.14.6）

    • 虽然okhttp最新版是4.x版，但因只是源码用kotlin改写了，所以Java环境下一班还是用3.x版本居多
  • feign-httpclient -> Apache HttpClient4.5.3（4.5.11）
  • feign-jackson -> Jackson 2.9.9.3（2.10.2）
  • feign-slf4j -> slf4j 1.7.13（1.7.30）
  • feign-hystrix -> hystrix-core 1.5.18（1.5.18） archaius-core 0.76（0.7.7）
  • feign-ribbon -> ribbon-core 2.3.0（2.7.17） ribbon-loadbalancer 2.3.0（2.7.17）
  • feign-spring4 -> spring-web 4.3.x (5.2.x)
    • feign-spring4它从feign的10.5.0版本才开始有哦，依赖于spring-web的4.3.x版本即可

说明：以上列出是开发中常见的库的版本号，基本上只要保持大版本号不变，可以替换成你自己的版本号，不会有冲突和不兼容现象（特别说明：okhttp并不建议使用4.x版本哦，因为3.x版本也一直在开发维护着…）

正文

Feign灵感来源于Retrofit、JAXRS-2.0和WebSocket，它旨在通过最少的资源和代码来实现和HTTP Client的能力。并且通过可定制的解码器和错误处理，编写任意的HTTP API。Feign使得 Java HTTP 客户端编写更方便。
该项目的github地址是：https://github.com/OpenFeign/feign

官网介绍

学习任何一门新技术，先官网，再实践，这是应有的态度。

产品原理图

产品路线图

官网最显眼部分放置了它的产品路线图。Feign还是蛮活跃的一个开源项目，它目前的最新版本是10.7.4，接下来它会把重心放在大版本11上，继续简化API的构建。

短期：目前正在做的
  • 响应缓存

    • 支持api响应的缓存。允许用户定义响应在什么条件下可以进行缓存，以及应该使用什么类型的缓存机制
    • 支持内存缓存和外部缓存实现(EhCache、咖啡因、Redis、Spring等)
  • 完整的URI模板表达式支持
    • 如果你是在Spring下构建它，好像Spring有提供URL构建工具
  • 日志API重构
    • 重构Logger API，使其更接近SLF4J这样的框架，从而为在Feign中进行日志记录提供一个通用的心智模型。这个模型将被整个过程中使用，并提供如何使用记录器的更清晰的方向。
  • 重试API重构
    • 重构Retry API以支持用户提供的条件并更好地控制回退策略。这可能导致非向后兼容的中断更改（向下不兼容）
中期：下一步会做的
  • Metric API（度量API，监控用）

    • 提供一个一流的度量API，用户可以利用它来洞察请求/响应的生命周期。可能提供更好的OpenTracing支持。
  • 通过CompletableFuture支持异步执行
    • 许对请求/响应生命周期进行未来的链接和执行程序管理。实现将需要非向后兼容的中断更改。但是，在考虑反应性执行Reactor模式之前，需要这个特性。
  • 支持Reactive Streams
    • 对于JDK 9+，考虑使用java.util.concurrent.Flow的本机实现。
    • 对于Java8，支持用Project Reactor或者RxJava 2+实现
长期：将来会做的
  • 附加断路器支持

    • 支持额外的断路器实现，如:Resilience4J以及和Spring自己的断路器（目前只支持到了Netflix的Hystrix）

为何选择Feign而非其它？

Feign使用Jersey和CXF等工具为REST或SOAP服务编写java客户端。此外，Feign允许您在http库(如Apache HttpClient)上编写自己的代码。Feign通过可定制的解码器和错误处理将您的代码与http API连接起来，并且只需要很少的开销。

Feign是如何工作的？

Feign的工作原理是：将注解处理成模板化的请求。参数在输出之前以一种简单的方式应用于这些模板。尽管Feign仅限于支持基于文本的api，但它极大地简化了系统方面如回放请求、重试。此外，了解这一点后，Feign可以轻松地对转换进行单元测试。

对Java版本的兼容性

Feign10.x和以上版本都是在Java 8上构建的（所以像feign-java8模块直接就移除了），且适用于Java 9、10和11。对于那些需要JDK 6兼容性的，请使用Feign 9.x

相关模块

Feign是一个完整的工程项目，除了core模块，还有众多其它实用模块（均为官方维护），截图展示如下：

除了截图这些模块其实还有比如：feign-java11、feign-googlehttpclient…等等非常多，其中：

  • feign-spring4模块自10.5.0版本才有
  • feign-googlehttpclient模块自10.4.0版本才有
  • …绝大多数模块从9.0开始就都有了，所以使用中不用担心

使用示例

对于程序员来说，文字说明都太过于抽象且枯燥，因此下面是重头戏，用示例来感受一把它Feign的使用。
若要使用Feign，你仅仅只需导入核心包即可，因是首个示例，所以展示其POM文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.youtbatman</groupId><artifactId>java-feign</artifactId><version>1.0-SNAPSHOT</version><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><feign.version>10.4.0</feign.version><lombok.version>1.18.10</lombok.version></properties><dependencies><dependency><groupId>io.github.openfeign</groupId><artifactId>feign-core</artifactId><version>${feign.version}</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><version>${lombok.version}</version><scope>provided</scope></dependency><dependency><groupId>junit</groupId><artifactId>junit</artifactId><version>4.12</version></dependency></dependencies><build><plugins><plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3.3</version><configuration><forceJavacCompilerUse>true</forceJavacCompilerUse><source>1.8</source><target>1.8</target></configuration></plugin></plugins></build>
</project>

准备服务端响应接口：

@Slf4j
@RestController
@RequestMapping("/feign")
public class FeignController {@GetMapping("/demo1")public String getDemo1(@RequestParam String name) {log.info(name);return "success:" + name;}
}

使用Feign书写客户端代码：

public interface DemoClient {@RequestLine("GET /feign/demo1?name={name}")String getDemo1(@Param("name") String name);
}

说明：因为使用的JDK动态代理，所以此处必须必须必须是接口

测试程序：

public static void main(String[] args) {DemoClient client = Feign.builder().target(DemoClient.class, "http://localhost:8080");String result = client.getDemo1("YourBatman");System.out.println(result);
}

运行程序，正常work。客户端正常收到返回值，输出为：

success:YourBatman

这是最最最最最最简单的一个Feign的使用案例，这里有很多的使用细节、坑等后面文章会一一描述，并且帮你填平。

Netflix Feign还是Open Feign？

在这个时间节点上，很多人对这“两种”Feign傻傻分不清楚，不知有何区别和联系，本文将给与告知。
首先需要明确：他俩是属于同一个东西，Feign属于Netflix开源的组件。针对于于差异性，下面分这几个方面展开做出对比

1、GAV坐标差异：

<dependency><groupId>com.netflix.feign</groupId><artifactId>feign-core</artifactId>
</dependency><dependency><groupId>io.github.openfeign</groupId><artifactId>feign-core</artifactId>
</dependency>

2、官网地址差异：
https://github.com/Netflix/feign和https://github.com/OpenFeign/feign。不过现在访问https://github.com/Netflix/feign已经被重定向到了后者上。

3、发版历史：

  • Netflix Feign：1.0.0发布于2013.6，于2016.7月发布其最后一个版本8.18.0
  • Open Feign：首个版本便是9.0.0版，于2016.7月发布，然后一直持续发布到现在（未停止）

从以上3个特点其实你可以很清楚的看到两者的区别和联系，简单的理解：Netflix Feign仅仅只是改名成为了Open Feign而已，然后Open Feign项目在其基础上继续发展至今。

9.0版本之前它叫Netflix Feign，自9.0版本起它改名叫Open Feign了。

但是请注意，虽然GAV完全变了，但是源码的包名和核心API是没有任何变化的，所以扔具有很好的向下兼容性（并不是100%向下兼容）。

spring-cloud-starter-feign还是spring-cloud-starter-openfeign？

他俩的差异类似于上述描述的差异，也从几个方面说明：

1、GAV坐标差异：

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

发版历史：

  • spring-cloud-starter-feign：2015.3发布1.0.0版本，2019.5.23发布器最后一个版本1.4.7.RELEASE

    • 值得注意的是，从1.4.0.RELEASE开始，它的1.4.x的发版轨迹完全同下的1.4.x的发版轨迹
  • spring-cloud-starter-openfeign：2017.11发布其首个版本，版本号为：1.4.0.RELEASE。现在仍持续更新中，当下最新版为2.2.1.RELEASE

说明：1.4.7.RELEASE是整个Spring Cloud1.x关于Feign方面的最终版本，2.x版本还在持续维护更新中

注意：老的spring-cloud-starter-feign 从1.2.0.RELEASE开始 已放弃Netflix feign而全面使用更新的Open Feign版本，而spring-cloud-starter-openfeign更是和Netflix Feign已经没有关系了。


对于版本，可粗略的理解为：spring-cloud-starter-openfeign是为Spring Cloud2.x准备的，只不过维持了一段时间的对1.x的兼容。而spring-cloud-starter-feign是专为Spring Cloud1.x服务。

核心API包名：
Spring Cloud的大版本升级具有向下不兼容性，这也体现在了Feign上：

  • @FeignClient注解：

    • 1.x版本包名是org.springframework.cloud.netflix.feign.FeignClient，所在Jar是spring-cloud-netflix-core

      • 说明：这里的1.x不仅仅指的feign，还包括openfeign的1.4.x版本哦
    • 2.x版本包名是org.springframework.cloud.openfeign.FeignClient，所在Jar是spring-cloud-openfeign-core
  • @EnableFeignClients注解：
    • 差异同上


总结

关于Feign的基本介绍就到这了，通过这篇文章能够了解到Feign作为一个Http Client的基本使用方法，以及它的产品线路图。
同时也介绍了困扰很多小朋友的Netflix Feign和Open Feign的区别，以及版本号上的差异。我相信害怕来自于未知，当你从底层掌握了这些知识点后，相信你使用起来更够更加得心应手。

关注A哥

Author A哥(YourBatman)
个人站点 www.yourbatman.cn
E-mail yourbatman@qq.com
微 信 fsx641385712
活跃平台
公众号 BAT的乌托邦（ID：BAT-utopia）
知识星球 BAT的乌托邦
每日文章推荐 每日文章推荐

  • [享学Jackson] 一、初识Jackson – 世界上最好的JSON库
  • [享学Jackson] 二、jackson-core之流式API与JsonFactory、JsonGenerator、JsonParser
  • [享学Jackson] 三、jackson-databind之ObjectMapper与数据绑定、树模型
  • [享学Jackson] 四、控制Jackson行为的特征们之JsonFactory.Feature、JsonGenerator.Feature、JsonParser.Feature
  • [享学Jackson] 五、控制Jackson行为的特征们之JsonWriteFeature、JsonReadFeature
  • [享学Jackson] 六、控制Jackson行为的特征们之MapperFeature、SerializationFeature、DeserializationFeature
  • [享学Jackson] 七、Jackson使用bit位运算来开启/禁用Feature的原理解析
  • [享学Jackson] 八、jackson-databind数据绑定基础配置之BaseSettings、MapperConfig、MapperConfigBase
  • [享学Jackson] 九、jackson-databind数据绑定序列化/反序列化配置之SerializationConfig、DeserializationConfig
  • [享学Jackson] 十、jackson-databind序列化之ObjectMapper序列化原理、序列化器匹配原理
  • [享学Jackson] 十一、jackson-databind之JsonSerializer序列化器全解析
  • [享学Jackson] 十二、jackson-databind反序列化之ObjectMapper反序列化原理、JsonDeserializer反序列化器全解析
  • [享学Jackson] 十三、jackson-annotation注解模块全解析及Jackson注解大全
  • [享学Jackson] 十四、深入理解Jackson的Module模块化设计及原理分析
  • [享学Jackson] 十五、第三方模块Module的深度实践：JavaTimeModule、JSR310Module、ParameterNamesModule、Jdk8Module
  • [享学Jackson] 十六、Jackson在Spring MVC中的使用之Date、JSR310时间类型的处理
  • [享学Jackson] 十七、spring-web整合Jackson源码解析之Jackson2ObjectMapperBuilder
  • [享学Jackson] 十八、Spring容器深度整合Jackson的桥梁之SpringHandlerInstantiator
  • [享学Jackson] 十九、Spring下使用ObjectMapper的正确姿势 — Jackson2ObjectMapperFactoryBean
  • [享学Jackson] 二十、Spring MVC下的Jackson — MappingJackson2HttpMessageConverter
  • [享学Jackson] 二十一、Spring Boot下的Jackson — JacksonAutoConfiguration自动配置
  • [享学Jackson] 二十二、Jackson与Fastjson的恩怨情仇（完结篇）

[享学Feign] 一、原生Feign初体验，Netflix Feign or Open Feign？相关推荐

  1. 【云原生】 初体验阿里云Serverless应用引擎SAE（三），挂载配置文件使应用的配置和运行的镜像解耦

    目录 一.前言 二.SAE配置 1.创建配置项 2.配置SAE Nginx服务 效果 1.[云原生] 初体验阿里云Serverless应用引擎SAE(一),部署Nginx服务 2.[云原生] 初体验阿 ...

  2. python从零学——scrapy初体验

    2019独角兽企业重金招聘Python工程师标准>>> python从零学--scrapy初体验 近日因为一些事情,需要从网上爬取一些东西,故而想通过使用爬虫来顺便学习下强大的pyt ...

  3. 风变编程有c语言吗,风变编程Python小课初体验：用有趣好玩的方式学编程

    原标题:风变编程Python小课初体验:用有趣好玩的方式学编程 经过约一个月时间的学习,今天,我终于学完风变编程Python小课的Python基础语法课程啦!从零基础的"小白"到现 ...

  4. 学成在线 第9天 讲义-课程预览 Eureka Feign Ribbon

    1Eureka注册中心 1.1需求分析 在前后端分离架构中,服务层被拆分成了很多的微服务,微服务的信息如何管理?Spring Cloud中提供服务注册中心来管理微服务信息. 为什么 要用注册中心? 1 ...

  5. 【你好Resilience4j】一：Resilience4j之初体验

    每日一句 健身和读书,是世界上成本最低的升值方式:而懒,是你通往牛逼的路上最大的敌人. 目录 为什么要使用Resilience4j Resilience4j介绍 Resilience4j模块 初体验 ...

  6. 一位Oracle老司机的openGauss初体验

    点击上方"蓝字" 关注我们,享更多干货! "8小时玩转openGauss训练营第二期"顺利结束啦!???????????? 本期活动共有939人报名,在线观看直 ...

  7. 亚马逊云科技Build On - Serverless创新零售初体验

    亚马逊云科技Build On - Serverless创新零售初体验 亚马逊云科技Build On - 基于 Serverless 构建零售创新应用 参与目的 参与过程 活动开始(直播) 活动实操 活 ...

  8. 作为开发者的开发游戏初体验

    前言 作为程序开发人员,没有接触游戏开发,是不完美的编程开发经历.虽然本人的技术水平有限,也知道做游戏开发的难度,但是还是有一个比较偶然的机会接触到了游戏开发.首先来分享一下,游戏开发说难很难,说容易 ...

  9. Spring环境搭建，IoC容器初体验~

    由于最近的任务是关于IoC配置文件格式的转换,所以需要从Spring的IoC容器开始学起,今天根据网上的介绍搭建了Spring环境,并对其IoC容器进行了初体验.文章中涉及到的软件以及推荐的一本关于S ...

最新文章

  1. (C++)小明种苹果（续）
  2. 梯度消失、梯度爆炸、过拟合问题之神经网络应对方案：数据预处理、批量归一化、非饱和激活函数、梯度缩放和梯度裁剪、权重初始化、提前终止、集成学习、l1l2、Dropout
  3. c++中类型用new和不用new的区别
  4. 给自己的Blog 上添加定制的搜索引擎
  5. linux运维工程师学习路线
  6. 适用于Java开发人员的Elasticsearch：Elasticsearch生态系统
  7. 互评Beta版本（Hello World！——SkyHunter）
  8. apache 部署python3_centos7.6+python3+apache2.4+django2.1.2网站部署总结
  9. c语言下建立直角坐标系,大地坐标系和地心地固直角坐标ECEF转换公式和C语言函数代码...
  10. 航空429接口测试工装研究
  11. 必备！万用表使用手册
  12. Nodejs中如何调用腾讯云的短信验证码接口并对接口进行安全限制
  13. 网付代理利润我把它分析得透透的
  14. 五款实用的微信小程序（免费证件照）
  15. 【C语言笔记】【宏定义系列】 判断是否2的n次幂对齐
  16. Child returned status 1问题解决
  17. 【转】cidaemon.exe进程CPU占用率高怎么办？
  18. 面试开课吧合并区间算法
  19. Android 入门第九讲01-音频（本地音乐播放，暂停，继续播放，获取播放时间，快进到指定位置，变速播放，播放data/data/目录下的音频文件，播放网络歌曲）
  20. 数值分析matlab最小二乘法,数值分析及其MATLAB实验（第2版）

热门文章

  1. 单片机STC89C52RC定时器
  2. 未来智能家居方向是什么模式？小米？华为？智汀？
  3. 本题要求对任意给定的一位正整数N，输出从1*1到N*N的部分口诀表。
  4. java运行applet的命令_Java工具JDK中用来运行Applet程序的命令是()
  5. java语言的编译器命令_Java编译器的命令是( )
  6. ​2022企业级BI平台白皮书（附下载）
  7. 用html5制作一个2d沙发,沙发诞生记——一套沙发的制作工艺及流程
  8. 卡通幼儿英语数学拼音早教机 官网
  9. 眼睛小被误判“开车睡觉”？网友：这波不怪小鹏，真的
  10. 移动增值业务随笔（2）