Spring Cloud Feign的两种使用姿势

原创

mb5fdcae83766b7 2021-01-18 14:09:18 ©著作权

文章标签 java 文章分类 Java 后端开发

©著作权归作者所有：来自51CTO博客作者mb5fdcae83766b7的原创作品，请联系作者获取转载授权，否则将追究法律责任

本文共 1169字，阅读大约需要 5分钟，文末有计时器可自行对时！

概述

最近结合一些别人的开源项目来学习Spring Cloud，其中关于服务消费这方面的一个很便利的工具 Feign让我记忆颇深。虽然网上的Demo和例子不胜枚举，但大多比较分散，本文就来集中记录一下声明式客户端 Feign的一些使用姿势。

注： 本文首发于 作者公众号 CodeSheep ，可 长按 / 扫描 下面的 小心心 来订阅 ↓ ↓ ↓

创建基于Eureka的服务注册中心

三个步骤即可搞定：

```
建工程
```

创建一个名为 eureka_server的 SpringBoot工程，并在pom.xml中添加好对应依赖

        <dependency>

            <groupId>org.springframework.cloud</groupId>

            <artifactId>spring-cloud-starter-eureka-server</artifactId>

        </dependency>

```
改主类
```

修改应用主类，添加 @EnableEurekaServer注解

@EnableEurekaServer

@SpringBootApplication

public class EurekaServerApplication {

    public static void main(String[] args) {

        SpringApplication.run(EurekaServerApplication.class, args);

    }

}

```
加配置
```

配置 application.properties 文件如下所示：

spring.application.name=eureka-server

server.port=1111

eureka.instance.hostname=localhost

#默认设置下，服务注册中心自己也会将自己作为客户端来尝试注册它自己，所以我们需要禁用它的客户端注册行为

eureka.client.register-with-eureka=false

eureka.client.fetch-registry=false

```
启动服务注册中心
```

浏览器访问之：

此时还没有任何服务注册上来。

创建服务提供者

```
建工程
```

创建一个名为 service_provider的 SpringBoot工程，并在pom.xml中添加好对应依赖：

    <dependencies>

        <dependency>

            <groupId>org.springframework.cloud</groupId>

            <artifactId>spring-cloud-starter-eureka</artifactId>

        </dependency>

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

    </dependencies>

```
改主类
```

添加 @EnableDiscoveryClient注解

@EnableDiscoveryClient

@SpringBootApplication

public class ServiceProviderApplication {

    public static void main(String[] args) {

        SpringApplication.run(ServiceProviderApplication.class, args);

    }

}

```
添加控制器 DateServiceController
```

提供一个Restful接口而已，该接口的作用是获取服务器上的时间并返回

@RestController

public class DateServiceController {

    @RequestMapping( value = "/test", method = RequestMethod.GET )

    public String test( @RequestParam String param ){

        return "hello " + param;

    }

}

```
配置 application.properties文件
```

    spring.application.name=service_provider

    server.port=1112

eureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/

```
启动工程
```

浏览器访问服务注册中心，我们发现服务提供者 service_provider已经注册到 eureka_server上：

同时浏览器访问： http://localhost:1112/test?param=www.codesheep.cn，可以测试服务提供 service_provider提供的接口工作正常接下来我们创建服务消费者，是 Feign该登场的时候了！

创建基于Feign的服务消费者

创建一个名为 service_consumer的 SpringBoot工程，并在pom.xml中添加好对应依赖

        <dependencies>

            <dependency>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-starter-web</artifactId>

            </dependency>

            <dependency>

                <groupId>org.springframework.cloud</groupId>

                <artifactId>spring-cloud-starter-eureka</artifactId>

            </dependency>

            <dependency>

                <groupId>org.springframework.cloud</groupId>

                <artifactId>spring-cloud-starter-feign</artifactId>

            </dependency>

            <dependency>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-starter-actuator</artifactId>

            </dependency>

            <dependency>

                <groupId>org.springframework.boot</groupId>

                <artifactId>spring-boot-starter-test</artifactId>

                <scope>test</scope>

            </dependency>

        </dependencies>

```
修改应用主类
```

主要是添加有关 Feign客户端的一些注解而已

@EnableFeignClients

@EnableDiscoveryClient

@SpringBootApplication

public class ServiceConsumerApplication {

    public static void main(String[] args) {

        SpringApplication.run(ServiceConsumerApplication.class, args);

    }

}

创建一个 Feign客户端的接口： DateServiceFeignClientInterface

很明显其内部用 @FeignClient(value="service-provider") 声明的方式指向了服务提供者，而接口方法则实现了对服务提供者接口的实际调用

@FeignClient( value = "service-provider" )

public interface DateServiceFeignClientInterface {

    @GetMapping("/test")

    String consumer( @RequestParam("param") String param );

}

创建控制器： DateServiceFeignController

注意，这是服务消费者提供的 Rest接口

@RestController

@RequestMapping("/consumer")

public class DateServiceFeignController {

    @Resource

    DateServiceFeignClientInterface dateServiceFeignClientInterface;

    @GetMapping("/date")

    public String getDate( @RequestParam String param ) {

        return dateServiceFeignClientInterface.consumer( param );

    }

}

```
配置 application.properties
```

    spring.application.name=service-consumer

    server.port=1113

    eureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/

```
启动服务消费者
```

我们先去服务注册中心上看看，发现服务消费者也注册上来了：然后我们浏览器访问服务消费者提供的Rest接口： http://localhost:1113/consumer/date?param=www.codesheep.cn 这样我们就通过服务消费者的 Feign客户端取到了服务提供者给予的接口数据。

上面这就是声明式客户端 Feign的第一种使用姿势，也是常用的手法，常见于很多Demo

下面我们来实践一下关于 Feign的继承与实现机制，发现其使用更加灵活（ Feign支持接口继承方式快速生成客户端，颇有点RPC的意思（关于RPC的实践可以参考我的文章：《RPC框架实践之：Google gRPC》、《RPC框架实践之：Apache Thrift》） ）

抽象出一个公共的API服务

创建一个普通 Maven项目： service_provider_api

创建一个公共接口： DateService

public interface DateService {

    @GetMapping("/api/test")

    String consumer( @RequestParam("param") String param );

}

改造之前的服务提供者/消费者

在服务消费者 service_consumer项目中添加一个新的Feign的客户端接口

    @FeignClient( value = "service-provider" )

    public interface DateServiceFeignClientInterface2 extends DateService {

    }

并且在 service_consumer项目中添加一个新的控制器 DateServiceFeignController2

    @RestController

    @RequestMapping("/consumer2")

    public class DateServiceFeignController2 {

        @Resource

        DateServiceFeignClientInterface2 dateServiceFeignClientInterface2;

        @GetMapping("/date")

        public String getDate( @RequestParam String param ) {

            return dateServiceFeignClientInterface2.consumer( param );

        }

    }

在服务提供者 service_provider项目中来实现我们在公共api项目 service_provider_api中的 DateService接口，赋予实际逻辑

    @RestController

    public class DateServiceController2 implements DateService {

        @Override

        public String consumer( @RequestParam String param) {

            Date now = new Date();

            SimpleDateFormat simpleDateFormat = new SimpleDateFormat("今天是"+"yyyy年MM月dd日 E kk点mm分" );

            String nowTime = simpleDateFormat.format( now );

            return "hello again " + param + ", " + nowTime;

        }

    }

依次将 eureka_server、 service_provider、 service_consumer 三个项目分别启动

浏览器访问： http://localhost:1113/consumer2/date?param=www.codesheep.cn

使用 feign的继承特性时，可以将服务接口的定义从服务消费者中剥离出去，形成独立的api项目从而可以很方便的实现接口定义和依赖的共享，不用再复制粘贴接口进行绑定，当然这种做法存在的问题就是可能会导致服务提供者和服务消费者间的耦合度增高，此时如果服务提供者修改了一个接口定义，服务消费者可能也得跟着变，进而带来一些坑。

后记

由于能力有限，若有错误或者不当之处，还请大家批评指正，一起学习交流！

我的个人博客：www.codesheep.cn

如果有兴趣，也可以抽时间看看作者更多系列的原创文章：

我的半年技术博客之路

利用K8S技术栈打造个人私有云连载文章

Spring Boot Admin 2.0 上手体验

利用TICK搭建Docker容器可视化监控中心

从一份配置清单详解Nginx服务器配置

Docker容器可视化监控中心搭建

利用ELK搭建Docker容器化应用日志中心

高效编写Dockerfile的几条准则

Docker容器跨主机通信

Spring Boot应用监控实战

RPC框架实践之：Google gRPC

RPC框架实践之：Apache Thrift

微服务调用链追踪中心搭建

作者更多务实、能看懂、可复现的原创文章尽在公众号 CodeSheep，欢迎订阅 ⬇️⬇️⬇️