＜番外篇＞spring-cloud Hoxton.SR2版服务注册与发现--zookeeper搭建以及远程调用（openfeign）使用

待我称王封你为后i 2021-09-24 12:04 355阅读 0赞

# <番外篇>spring-cloud Hoxton.SR2版 服务注册与发现–zookeeper搭建以及远程调用（openfeign）使用 #

### 文章目录 ###

*  <番外篇>spring-cloud Hoxton.SR2版 服务注册与发现--zookeeper搭建以及远程调用（openfeign）使用
 *   *  1、zookeeper的搭建
     *   *  1.1、linux环境下搭建
         *  1.2、docker搭建
     *  2、项目搭建--服务的提供者badger-spring-cloud-zk-api
     *   *  2.1、maven的pom文件如下：主要spring-cloud-starter-zookeeper-discovery这个包
         *  2.2、springboot主类如下
         *  2.3、controller业务类
         *  2.4、application.yml配置文件如下
     *  3、项目搭建--服务的调用者badger-spring-cloud-zk-openfeign
     *   *  3.1、maven的pom文件如下：同样需要spring-cloud-starter-zookeeper-discovery这个包
         *  3.2、springboot主类如下
         *  3.3、openFeign远程调用的接口
         *  3.4、controller业务类
         *  3.5、application.yml配置文件如下
     *  4、测试
     *   *  1、启动应用\`服务的提供者badger-spring-cloud-zk-api\`端口为7000；
         *  2、启动应用\`服务的调用者badger-spring-cloud-zk-openfeign\`端口为8000；

本地项目的基础环境

<table> 
 <thead> 
  <tr> 
   <th align="center">环境</th> 
   <th align="center">版本</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="center">jdk</td> 
   <td align="center">1.8.0_201</td> 
  </tr> 
  <tr> 
   <td align="center">maven</td> 
   <td align="center">3.6.0</td> 
  </tr> 
  <tr> 
   <td align="center">Spring-boot</td> 
   <td align="center">2.2.4.RELEASE</td> 
  </tr> 
  <tr> 
   <td align="center">Spring-cloud</td> 
   <td align="center">Hoxton.SR2</td> 
  </tr> 
  <tr> 
   <td align="center">zookeeper</td> 
   <td align="center">3.5</td> 
  </tr> 
 </tbody> 
</table>

## 1、zookeeper的搭建 ##

### 1.1、linux环境下搭建 ###

详细搭建，可以参考

[《linux下安装zookeeper》][linux_zookeeper]

[《zookeeper在linux下的集群搭建》][zookeeper_linux]

### 1.2、docker搭建 ###

为了简单方便的快速搭建，本次使用的zookeeper，将使用docker搭建；

spring-cloud 版本使用的`Hoxton.SR2`；对应的zookeeper版本jar包为`zookeeper-3.5.3-beta.jar`；docker下载的版本为`3.5`;

如果在搭建过程中，出现一些报错信息，也可以检查下zookeeper的jar包以及对应的版本的问题；

1、下载docker的zookeeper镜像对应的版本；

docker pull zookeeper:3.5

![7be224a943df036676075d5ac650656b.png][]

2、创建一个zookeeper镜像的容器，并启动

docker run --name zookeeper_01 -p 2181:2181 --restart always -d zookeeper:3.5

3、查看zookeeper容器启动情况

docker ps

具体的可以参考[《docker-hub》][docker-hub]；上面也有具体的`docker-compose`脚本，启动集群的方式等；

## 2、项目搭建–服务的提供者badger-spring-cloud-zk-api ##

### 2.1、maven的pom文件如下：主要spring-cloud-starter-zookeeper-discovery这个包 ###

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.2.4.RELEASE</version>
            <relativePath /> 
        </parent>
        <groupId>com.badger</groupId>
        <artifactId>badger-spring-cloud-zk-api</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>badger-spring-cloud-zk-api</name>
        <description>Demo project for Spring Boot</description>
    
        <properties>
            <java.version>1.8</java.version>
            <maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
            <spring-cloud.version>Hoxton.SR2</spring-cloud.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-zookeeper-discovery</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
            </dependency>
        </dependencies>
    
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-dependencies</artifactId>
                    <version>${spring-cloud.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    </project>

### 2.2、springboot主类如下 ###

@SpringBootApplication
    @EnableDiscoveryClient
    public class ZookeeperApiApplication { 
    
        public static void main(String[] args) throws Exception { 
            SpringApplication.run(ZookeeperApiApplication.class, args);
        }
    }

`@EnableDiscoveryClient`注解：是开启自动注册；

### 2.3、controller业务类 ###

@RestController
    public class DemoController { 
    
        @Value("${server.port}")
        String port;
    
        @Value("${spring.cloud.client.ip-address}")
        String address;
    
        @GetMapping("/zk/demo")
        public String demo() { 
            return "我的地址是-->" + address + ":" + port;
        }
    }

### 2.4、application.yml配置文件如下 ###

server:
      port: 7000
    spring:
      application:
        name: badger-spring-cloud-zk-api
      cloud:
        zookeeper:
          connect-string: 127.0.0.1:2181
          discovery:
            enabled: true
            register: true

更详细的配置内容可以参考`org.springframework.cloud.zookeeper.discovery.ZookeeperDiscoveryProperties.class`配置类；

## 3、项目搭建–服务的调用者badger-spring-cloud-zk-openfeign ##

### 3.1、maven的pom文件如下：同样需要spring-cloud-starter-zookeeper-discovery这个包 ###

当前案例，主要演示使用openfeign作为远程调用；单独使用ribbon调用就不再单独演示了；

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.2.4.RELEASE</version>
            <relativePath /> 
        </parent>
        <groupId>com.badger</groupId>
        <artifactId>badger-spring-cloud-zk-openfeign</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>badger-spring-cloud-zk-openfeign</name>
        <description>Demo project for Spring Boot</description>
    
        <properties>
            <java.version>1.8</java.version>
            <maven-jar-plugin.version>3.1.1</maven-jar-plugin.version>
            <spring-cloud.version>Hoxton.SR2</spring-cloud.version>
        </properties>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-openfeign</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.cloud</groupId>
                <artifactId>spring-cloud-starter-zookeeper-discovery</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-test</artifactId>
                <scope>test</scope>
                <exclusions>
                    <exclusion>
                        <groupId>org.junit.vintage</groupId>
                        <artifactId>junit-vintage-engine</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
        </dependencies>
    
        <dependencyManagement>
            <dependencies>
                <dependency>
                    <groupId>org.springframework.cloud</groupId>
                    <artifactId>spring-cloud-dependencies</artifactId>
                    <version>${spring-cloud.version}</version>
                    <type>pom</type>
                    <scope>import</scope>
                </dependency>
            </dependencies>
        </dependencyManagement>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
            </plugins>
        </build>
    </project>

### 3.2、springboot主类如下 ###

@SpringBootApplication
    @EnableFeignClients
    @EnableDiscoveryClient
    public class ZookeeperOpenfeignApplication { 
    
        public static void main(String[] args) throws Exception { 
            SpringApplication.run(ZookeeperOpenfeignApplication.class, args);
        }
    
    }

需要加 `@EnableDiscoveryClient`注解，把当前服务注册到注册中心中

### 3.3、openFeign远程调用的接口 ###

/** * feign接口 指定调用哪个接口 * 注解：@FeignClient 标注为feign接口 value 指向调用的模块名 * spring boot 2.0 只有一个服务端（value = "同一个名字"），只能写一个注解, * 可以使用contextId 作为区分,而写多个@FeignClient * @author liqi , */
    @FeignClient(value = "badger-spring-cloud-zk-api")
    public interface DemoFeignApi { 
    
        @GetMapping("/zk/demo")
        String demo();
    }

注意：`@FeignClient(value = "badger-spring-cloud-zk-api")`；value属性`badger-spring-cloud-zk-api`

使用Eureka作为注册中心，在注册中，显示的是大写，然后配置的时候，需要`大写`;

使用zookeeper作为注册中心，在注册中，显示的是小写，那么在配置的时候，也需要`小写`

![d87324dc16d2caa27316de62eefbf473.png][]

### 3.4、controller业务类 ###

@RestController
    public class DemoController { 
        @Autowired(required = false)
        DemoFeignApi api;
    
        @GetMapping("/zk/feign/demo")
        public String demo() { 
            return api.demo();
        }
    }

### 3.5、application.yml配置文件如下 ###

server:
      port: 8000
    spring:
      application:
        name: badger-spring-cloud-zk-openfeign
      cloud:
        loadbalancer:
          ribbon:
            enabled: true
        zookeeper:
          connect-string: 127.0.0.1:2181

## 4、测试 ##

### 1、启动应用`服务的提供者badger-spring-cloud-zk-api`端口为7000； ###

[http://localhost:7000/zk/demo][http_localhost_7000_zk_demo]

访问结果:`我的地址是-->172.16.2.54:7000`

### 2、启动应用`服务的调用者badger-spring-cloud-zk-openfeign`端口为8000； ###

[http://localhost:8000/zk/feign/demo][http_localhost_8000_zk_feign_demo]

访问结果:`我的地址是-->172.16.2.54:7000`

如果需要负载均衡测试，那么服务提供者，使用不用的端口，多启动几个服务就可以了；

具体代码信息，可以查看《[码云》][Link 1]

[linux_zookeeper]: https://blog.csdn.net/qq_28410283/article/details/83927454
[zookeeper_linux]: https://blog.csdn.net/qq_28410283/article/details/84653935
[7be224a943df036676075d5ac650656b.png]: /images/20210923/cf0a8924dab84c699b8634c62e0ebab1.png
[docker-hub]: https://hub.docker.com/_/zookeeper?tab=description
[d87324dc16d2caa27316de62eefbf473.png]: /images/20210923/2bf7832e4c594f7a9d1bc6dae9d36a85.png
[http_localhost_7000_zk_demo]: http://localhost:7000/zk/demo
[http_localhost_8000_zk_feign_demo]: http://localhost:8000/zk/feign/demo
[Link 1]: https://gitee.com/liqi01/badger-spring-cloud