上一章节, 讲解了 SpringCloud 如何通过 RestTemplate+Ribbon 去负载均衡消费服务, 本章主要讲述如何通过 Feign 去消费服务.
一, Feign 简介:
Feign 是一个便利的 REST 框架, 在 Ribbon 的基础上进行了一次改进, 采用接口的方式, 将需要调用的其他服务的方法定义成抽象方法, 不需要自己构建 http 请求, 简化了调用. 但是最后的原理还是通过 ribbon 在注册服务器中找到服务实例, 然后对请求进行分配.
在工作中, 我们基本上都是使用 Feign 来进行服务调用, 因为 Feign 使用起来就像是调用自身本地的方法一样, 而感觉不到是调用远程方法, 相当舒服, 它主要有 3 个优点.
1. feign 本身里面就包含有了 ribbon, 具有负载均衡的能力
2. fegin 是一个采用基于接口的注解的编程方式, 更加简便
3. fegin 整合了 Hystrix, 具有熔断的能力
二, 准备工作:
对于 springcloud-eureka-client 工程不清楚了, 可以参考: 一起来学 Spring Cloud | 第二章: 服务注册和发现组件 (Eureka)
1. 启动 eureka-server 工程, eureka 注册中心就启动了.
2. 启动 springcloud-eureka-client 工程, springcloud-eureka-client 工程的端口为 9300.
3. 将 springcloud-eureka-client 工程的 application.properties 文件中端口改成 9400, 然后再启动 springcloud-eureka-client.
通过上面步骤, 我们就启动了端口 9300,9400 两个一样的 springcloud-eureka-client 服务模块 (为了测试 feign 的负载均衡能力).
三, 新建一个 feign 服务:
1. 新建一个 spring-boot 工程, 取名为 springcloud-feign-client, 修改 pox 文件如下:
- <?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>
- <parent>
- <groupId>com.haly</groupId>
- <artifactId>springcloud</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- </parent>
- <groupId>com.haly</groupId>
- <artifactId>springcloud-feign-client</artifactId>
- <version>0.0.1-SNAPSHOT</version>
- <name>springcloud-ribbon-client</name>
- <description > 新建一个 springcloud 项目 </description>
- <dependencies>
- <dependency>
- <groupId>org.springframework.cloud</groupId>
- <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
- </dependency>
- <dependency>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-starter-web</artifactId>
- </dependency>
- <dependency>
- <groupId>org.springframework.cloud</groupId>
- <artifactId>spring-cloud-starter-openfeign</artifactId>
- </dependency>
- </dependencies>
- <build>
- <plugins>
- <plugin>
- <groupId>org.springframework.boot</groupId>
- <artifactId>spring-boot-maven-plugin</artifactId>
- </plugin>
- </plugins>
- </build>
- </project>
如果有同学对上面配置 pom 文件中的 parent 标签引入的父 pom 有疑问, 可以参考一下 一起来学 Spring Cloud | 第二章: 服务注册和发现组件 (Eureka) , 讲解了自己定义一个父 pom 的作用
如果有同学不想从头搭建模块, 也可以在 parant 标签中直接引入 springboot 的配置, 但是注意本章节所使用的依赖包兼容的版本号为:
springboot :2.1.4.RELEASE ,springcloud:Finchley.RELEASE
2. 修改 application.properties 文件如下
- server.port=9600
- spring.application.name=springcloud-feign-client
- eureka.client.serviceUrl.defaultZone=http://localhost:8761/eureka/
3. 模块启动类需要增加注解 @EnableFeignClients, 表示开启 Feign 的功能
- package com.haly.springcloud;
- import org.springframework.boot.SpringApplication;
- import org.springframework.boot.autoconfigure.SpringBootApplication;
- import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
- import org.springframework.cloud.openfeign.EnableFeignClients;
- @SpringBootApplication
- @EnableFeignClients
- @EnableDiscoveryClient
- public class SpringcloudFeignClientApplication {
- public static void main(String[] args) {
- SpringApplication.run(SpringcloudFeignClientApplication.class, args);
- }
- }
4. 定义一个 feign 接口, 通过 @FeignClient("服务名"), 来指定调用哪个服务. 本章案例中调用了 springcloud-eureka-client 服务的 "/hello" 接口
springcloud-eureka-client 模块中的 hello 接口, 在第二章已经实现, 具体实现可以参考: 一起来学 Spring Cloud | 第二章: 服务注册和发现组件 (Eureka)
ps: 抽象方法的注解, 方法名, 参数要和服务提供方保持一致 (这里是与 springcloud-eureka-client 模块中的 /hello 方法保持一致)
- package com.haly.springcloud.romote;
- import org.springframework.cloud.openfeign.FeignClient;
- import org.springframework.Web.bind.annotation.RequestMapping;
- import org.springframework.Web.bind.annotation.RequestMethod;
- import org.springframework.Web.bind.annotation.RequestParam;
- @FeignClient(value = "springcloud-eureka-client")
- public interface FeignRemoteService {
- @RequestMapping(value = "/hello",method = RequestMethod.GET)
- public String hello(@RequestParam(value = "name") String name);
- }
5. controller 层, 对外暴露一个 "/getHello" 的 API 接口, 给页面测试, 通过上面定义的 Feign 客户端 FeignRemoteService 来消费服务. 代码如下:
- package com.haly.springcloud.controller;
- import org.springframework.beans.factory.annotation.Autowired;
- import org.springframework.Web.bind.annotation.GetMapping;
- import org.springframework.Web.bind.annotation.RequestParam;
- import org.springframework.Web.bind.annotation.RestController;
- import com.haly.springcloud.romote.FeignRemoteService;
- @RestController
- public class FeignController {
- @Autowired
- FeignRemoteService feignRemoteService;
- @GetMapping(value = "/getHello")
- public String getHello(@RequestParam String name) {
- return feignRemoteService.hello(name);
- }
- }
6. 启动各个服务模块, 服务注册结果如下
访问地址 http://localhost:9600/getHello?name=young 码农 , 多次轮流访问页面, 出现 9300,9400 服务接口返回结果, 证明 feign 是整合了负载均衡功能
四, 总结:
加上本章节代码后, 代码目录结构:
来源: https://www.cnblogs.com/haly/p/10857752.html