Spring Cloud Alibaba学习笔记:5、创建服务消费者（Feign）

柔情只为你懂 2021-12-13 13:23 268阅读 0赞

### 文章目录 ###

*   *   *   *  前言
             *  Feign 概述
             *  创建feign 服务消费者
             *   *  1、 创建一个maven module 项目 \`sca-nacos-discovery-consumer-feign\`
                 *  2、 pom
                 *  3、创建应用主类别 \`ScaNacosFeignApplication\`
                 *  4、创建 feign 客户端
                 *  5、创建 \`ConsumerController\`
                 *  6、配置服务端口、名称、服务端点检查和Nacos地址
                 *  7、启动Feign服务消费者
                 *  8、检查nacos 控制台
                 *  9、测试消费者
                 *   *  > 测试服务消费API
                     *  > 测试服务负载

#### 前言 ####

上篇文章， [Spring Cloud Alibaba学习笔记:4、创建服务消费者（RestTemplate + LoadBalancerClient）][Spring Cloud Alibaba_4_RestTemplate _ LoadBalancerClient]，  
我们一起学习了 使用 RestTemplate + LoadBalancerClient 的方式 去创建服务消费者，但是依旧显得繁琐，本文，我们将结合使用 spring-cloud-openfeign 来创建服务消费者，简化消费调用…  
一起开始吧

#### Feign 概述 ####

> Feign 是一个声明式的伪 Http 客户端，它使得写 Http 客户端变得更简单。使用 Feign，只需要创建一个接口并注解。它具有可插拔的注解特性，可使用 Feign 注解和 JAX-RS 注解。Feign 支持可插拔的编码器和解码器。Feign 默认集成了 Ribbon，Nacos 也很好的兼容了 Feign，默认实现了负载均衡的效果

*  Feign 采用的是基于接口的注解
 *  Feign 整合了 ribbon

#### 创建feign 服务消费者 ####

##### 1、 创建一个maven module 项目 `sca-nacos-discovery-consumer-feign` #####

##### 2、 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>
        <parent>
            <groupId>cn.fxbin.learn</groupId>
            <artifactId>sca</artifactId>
            <version>1.0</version>
        </parent>
    
        <artifactId>sca-nacos-discovery-consumer-feign</artifactId>
        <version>1.0</version>
        <name>sca-nacos-discovery-consumer-feign</name>
        <description>Spring Cloud Alibaba Nacos Discovery Consumer Feign Service Project</description>
    
        <dependencies>
            
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
    
            
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-alibaba-nacos-discovery</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>

##### 3、创建应用主类别 `ScaNacosFeignApplication` #####

package cn.fxbin.learn.sca.nacos.consumer;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
    import org.springframework.cloud.openfeign.EnableFeignClients;
    
    @EnableFeignClients
    @EnableDiscoveryClient
    @SpringBootApplication
    public class ScaNacosFeignApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(ScaNacosFeignApplication.class, args);
        }
    
    }

##### 4、创建 feign 客户端 #####

package cn.fxbin.learn.sca.nacos.consumer.client;
    
    import org.springframework.cloud.openfeign.FeignClient;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.PathVariable;
    
    /**
     * DiscoveryClient
     *
     * @author fxbin
     * @version v1.0
     * @since 2019/7/7 22:47
     */
    @FeignClient("sca-nacos-discovery-provider")
    public interface DiscoveryClient {
    
        @GetMapping(value = "/echo/{message}")
        String echo(@PathVariable String message);
    
    }

##### 5、创建 `ConsumerController` #####

package cn.fxbin.learn.sca.nacos.consumer.controller;
    
    import cn.fxbin.learn.sca.nacos.consumer.client.DiscoveryClient;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import javax.annotation.Resource;
    
    /**
     * ConsumerController
     *
     * @author fxbin
     * @version v1.0
     * @since 2019/7/7 20:36
     */
    @Slf4j
    @RestController
    public class ConsumerController {
    
        @Resource
        private DiscoveryClient discoveryClient;
    
        @GetMapping(value = "/test")
        public String test() {
            return discoveryClient.echo(" !^@^! ");
        }
    
    }

##### 6、配置服务端口、名称、服务端点检查和Nacos地址 #####

server:
      port: 9033
    
    management:
      endpoints:
        web:
          exposure:
            include: "*"
    
    spring:
      application:
        name: sca-nacos-discovery-consumer-feign
      cloud:
        nacos:
          discovery:
            server-addr: 127.0.0.1:8848

##### 7、启动Feign服务消费者 #####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70]

##### 8、检查nacos 控制台 #####

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 1]

##### 9、测试消费者 #####

###### > 测试服务消费API ######

postman 调用 api: http://localhost:9033/test

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 2]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 3]

###### > 测试服务负载 ######

*  修改`sca-nacos-discovery-provider` 服务 api, 打印当前服务端口

@RestController
      public class EchoController {
    
           @Value("${server.port}")
           private String port;
     
          @GetMapping(value = "/echo/{message}")
          public String echo(@PathVariable String message) {
              return "Hello Nacos Discovery Provider : " + message + ", port :" + port;
          }
      }

*  接下来重新启动原有实例，并再启动一个 `sca-nacos-discovery-provide` 的实例， 如下所示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 4]
 *  再次请求 http://localhost:9033/test , 会交替显示如下信息：

Hello Nacos Discovery Provider :  !^@^! , port :8081
    Hello Nacos Discovery Provider :  !^@^! , port :9030

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 5]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 6]

源码地址：  
github地址: https://github.com/fxbin/sca  
码云地址 : https://gitee.com/fxbin/sca

--------------------

– `end` –

`如有疑问，请留言或者发送邮件，感谢您的阅读`

[Spring Cloud Alibaba_4_RestTemplate _ LoadBalancerClient]: https://blog.csdn.net/fxbin123/article/details/95025897
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70]: /images/20211213/521bf120d42e4820b1339f9fbaacbc83.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 1]: /images/20211213/1bd51a367f4b4fe28551881652dfb9b2.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 2]: /images/20211213/2f7aface7c2245288a4864b108fcf797.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 3]: /images/20211213/86fc1ce3736f436e9eabfa57c88a8046.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 4]: /images/20211213/15e62e7906044ffe995b121ac11a39dd.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 5]: /images/20211213/b16274ab0c9c4a70af75772fa3f38659.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2Z4YmluMTIz_size_16_color_FFFFFF_t_70 6]: /images/20211213/466bef7c6b5848209eb997d275300905.png