Spring Cloud 系列之 Feign 声明式服务调用(一)
Feign 是 Spring Cloud Netflix 组件中的一个轻量级 RESTful 的 HTTP 服务客户端,实现了负载均衡和 Rest 调用的开源框架,封装了 Ribbon 和 RestTemplate,实现了 WebService 的面向接口编程,进一步降低了项目的耦合度。
Feign 内置了 Ribbon,用来做客户端负载均衡调用服务注册中心的服务。
Feign 本身并不支持 Spring MVC 的注解,它有一套自己的注解,为了更方便的使用,Spring Cloud 孵化了 OpenFeign。
Feign 是一种声明式、模板化的 HTTP 客户端(仅在 Consumer 中使用)。
Feign 支持的注解和用法请参考官方文档:https://github.com/OpenFeign/feign 或 spring.io 官网文档
Feign 的使用方式是:使用 Feign 的注解定义接口,调用这个接口,就可以调用服务注册中心的服务。
2|0Feign 解决什么问题
Feign 旨在使编写 JAVA HTTP 客户端变得更加容易,Feign 简化了 RestTemplate 代码,实现了 Ribbon 负载均衡,使代码变得更加简洁,也少了客户端调用的代码,使用 Feign 实现负载均衡是首选方案。只需要你创建一个接口,然后在上面添加注解即可。
Feign 是声明式服务调用组件,其核心就是:像调用本地方法一样调用远程方法,无感知远程 HTTP 请求。
-
它解决了让开发者调用远程接口就跟调用本地方法一样的体验,开发者完全感知不到这是远程方法,更感知不到这是个 HTTP 请求。无需关注与远程的交互细节,更无需关注分布式环境开发。
-
它像 Dubbo 一样,Consumer 直接调用 Provider 接口方法,而不需要通过常规的 Http Client 构造请求再解析返回数据。
3|0Feign vs OpenFeign
OpenFeign 是 Spring Cloud 在 Feign 的基础上支持了 Spring MVC 的注解,如 @RequesMapping
、@Pathvariable
等等。
OpenFeign 的 @FeignClient
可以解析 SpringMVC 的 @RequestMapping
注解下的接口,并通过动态代理的方式产生实现类,实现类中做负载均衡并调用服务。
4|0Feign 入门案例
点击链接观看:Feign 入门案例视频(获取更多请关注公众号「哈喽沃德先生」)
feign-demo
聚合工程。SpringBoot 2.2.4.RELEASE
、Spring Cloud Hoxton.SR1
。
Feign 的使用主要分为以下几个步骤:
- 服务消费者添加 Feign 依赖;
- 创建业务层接口,添加
@FeignClient
注解声明需要调用的服务; - 业务层抽象方法使用 SpringMVC 注解配置服务地址及参数;
- 启动类添加
@EnableFeignClients
注解激活 Feign 组件。
4|1创建项目
PS:服务消费者通过 Eureka 注册中心获取服务,或者 Ribbon 点对点直连模式都可以使用 Feign 来实现。
我们创建聚合项目并使用 Eureka 注册中心来讲解 Feign,首先创建一个 pom 父工程。
4|2添加依赖
pom.xml
4|3注册中心 eureka-server
注册中心我们采用集群方式构建,本文中使用两个节点分别是 eureka-server
和 eureka-server02
。
创建项目
eureka-server 和 eureka-server02 的创建过程一致。
添加依赖
eureka-server 和 eureka-server02 的依赖配置一致。
pom.xml
配置文件
eureka-server 的 application.yml
eureka-server02 的 application.yml
启动类
eureka-server 和 eureka-server02 的启动类一致。
EurekaServerApplication.java
4|4服务提供者 service-provider
服务提供者我们采用集群方式构建,本文中使用两个节点分别是 service-provider
和 service-provider02
。
创建项目
service-provider 和 service-provider02 的创建过程一致。
添加依赖
service-provider 和 service-provider02 的依赖配置一致。
pom.xml
配置文件
service-provider 的 application.yml
service-provider02 的 application.yml
实体类
service-provider 和 service-provider02 的实体类一致。
Product.java
编写服务
service-provider 和 service-provider02 的服务代码一致。
ProductService.java
ProductServiceImpl.java
控制层
service-provider 和 service-provider02 的控制层一致。
ProductController.java
启动类
service-provider 和 service-provider02 的启动类一致。
ServiceProviderApplication.java
4|5服务消费者 service-consumer
创建项目
在刚才的父工程下创建一个 service-consumer
服务消费者的项目。
添加依赖
服务消费者添加 openfeign
依赖。
pom.xml
配置文件
application.yml
实体类
Product.java
Order.java
消费服务
ProductService.java
OrderService.java
OrderServiceImpl.java
控制层
OrderController.java
启动类
ServiceConsumerApplication.java
访问
当前环境运行结果如下:
访问:http://localhost:9090/order/1
5|0Feign 负载均衡
Feign 封装了 Ribbon 自然也就集成了负载均衡的功能,默认采用轮询策略。如何修改负载均衡策略呢?与之前学习 Ribbon 时讲解的配置是一致的。
5|1全局
在启动类或配置类中注入负载均衡策略对象。所有服务请求均使用该策略。
5|2局部
修改配置文件指定服务的负载均衡策略。格式:服务应用名.ribbon.NFLoadBalancerRuleClassName
6|0Feign 请求传参
6|1GET
使用 @PathVariable
注解或 @RequestParam
注解接收请求参数。
服务提供者
ProductService.java
ProductServiceImpl.java
ProductController.java
服务消费者
ProductService.java
OrderServiceImpl.java
访问
访问:http://localhost:9090/order/3 结果如下:
6|2POST
使用 @RequestBody
注解接收请求参数。
服务提供者
ProductService.java
ProductServiceImpl.java
ProductController.java
服务消费者
ProductService.java
为了方便测试,直接创建入口调用,不通过订单服务去调用商品服务了。
ProductController.java
访问
访问:http://localhost:9090/product/info 请求参数为 id=5
结果如下:
访问:http://localhost:9090/product/save 请求参数为 id=6&productName=耳机&productNum=1&productPrice=288
结果如下:
下一篇我们讲解 Feign 性能优化的问题,Gzip压缩、HTTP连接池、请求超时等,记得关注噢~