SpringCloud技术指南系列（九）配置管理之Zookeeper配置中心

秒速五厘米 2024-04-17 06:04 159阅读 0赞

## SpringCloud技术指南系列（九）配置管理之Zookeeper配置中心 ##

### 一、概述 ###

Spring Boot应用的配置文件有多种：

1.  我们可以将配置内容写入application.yml
2.  设置多个profile，也可以用多个application-\{profile\}.properties文件配置
3.  命令行参数
4.  自定义配置文件
5.  配置中心

详细可以查看[《SpringBoot入门建站全系列（二十三）配置文件优先级及常用配置方式》][SpringBoot].

以上，除了配置中心，其他方式都不能动态去改变配置，并且生效，只有配置中心可以动态修改配置并生效。当然，并不是所有配置都能生效的，Spring加载后不再变化的配置，是不可能动态改变的，比如启动参数、zuul/gateway代理转发配置.

上一篇[《SpringCloud技术指南系列（八）配置管理之Consul配置中心》][SpringCloud_Consul]，我们讲的是如何使用consul做配置中心对配置进行管理。这一篇，我们讲一下如果使用zookeeper做配置中心。

代码可以在SpringBoot组件化构建[https://www.pomit.cn/java/spring/springcloud.html][https_www.pomit.cn_java_spring_springcloud.html]中的ZkConfig组件中查看，并下载。

ZkConfig组件中同时使用了服务注册发现，和博文中的代码略有不同，但原理是一样的，代码都已经过验证。

首发地址：  
[品茗IT-首先发布][IT-]

**如果大家正在寻找一个java的学习环境，或者在开发中遇到困难，可以[加入我们的java学习圈，点击即可加入][java]，共同学习，节约学习时间，减少很多在学习中遇到的难题。**

## 二、项目配置 ##

首先需要安装zookeeper，如果没有安装过，可以参考[《Web基础配置篇（十一）: Zookeeper的安装配置及使用》][Web_ Zookeeper]。 建议安装里面讲的安装zkui可视化工具，方便进行测试。

### 2.1 引入依赖 ###

需要引入spring-boot-starter-web和spring-cloud-starter-zookeeper-config.

**spring-cloud-starter-zookeeper-config默认引入的zookeeper是3.5的版本，因此如果你安装的zookeeper是3.4的版本，就必须排除zookeeper的依赖，并引入3.4的版本。**

依赖如下：

<?xml version="1.0"?>
    <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    	<modelVersion>4.0.0</modelVersion>
    	<parent>
    		<groupId>cn.pomit</groupId>
    		<artifactId>springcloudwork</artifactId>
    		<version>0.0.1-SNAPSHOT</version>
    	</parent>
    	<artifactId>ZkConfig</artifactId>
    	<name>ZkConfig</name>
    	<url>http://maven.apache.org</url>
    
    	<properties>
    		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    		<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    		<java.version>1.8</java.version>
    		<maven-jar-plugin.version>2.6</maven-jar-plugin.version>
    	</properties>
    
    	<dependencies>
    		<dependency>
    			<groupId>org.springframework.boot</groupId>
    			<artifactId>spring-boot-starter-web</artifactId>
    		</dependency>
    		<dependency>
    			<groupId>org.apache.zookeeper</groupId>
    			<artifactId>zookeeper</artifactId>
    			<version>3.4.14</version>
    			<exclusions>
    				<exclusion>
    					<groupId>org.slf4j</groupId>
    					<artifactId>slf4j-log4j12</artifactId>
    				</exclusion>
    			</exclusions>
    		</dependency>
    		<dependency>
    			<groupId>org.springframework.cloud</groupId>
    			<artifactId>spring-cloud-starter-zookeeper-config</artifactId>
    		</dependency>
    	</dependencies>
    </project>

父模块pom文件可以在[https://www.pomit.cn/spring/SpringCloudWork/pom.xml][https_www.pomit.cn_spring_SpringCloudWork_pom.xml]获取。

### 二、配置文件 ###

这里使用yaml文件写配置，配置文件分为两个，bootstrap.yml和application.yml：

*  bootstrap.yml的优先级高于application.yml。
 *  配置中心的相关配置必须放在bootstrap.yml中，否则无效。

**bootstrap.yml：**

server:
       port: 8816
       
    spring:
       application:
          name: zkConfig
       profiles:
          active: dev
       cloud:
          zookeeper:
             connect-string: localhost:2181
             config:
                enabled: true
                root: config
                profileSeparator: ','

这里面，包含了端口、应用名、consul配置中心信息。

spring.application.name是标识了应用名。

spring.profiles.active 是激活的环境，你可以不写对应的配置文件，但这个配置必须有，是zookeeper配置中心路径的一部分。

spring.cloud.zookeeper.connect-string是zookeeper服务器地址。

spring.cloud.zookeeper.config.enabled开启配置中心功能。

spring.cloud.zookeeper.config.root是zookeeper的配置路径根目录。

spring.cloud.zookeeper.config.profileSeparator是profile和应用名直接的分隔符。

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

比如我这里写了个welcom.value配置。路径是config下的zkConfig,dev 下的welcom.value。

**application.yml：**

application.yml中仍可以配置一些常用配置，我这里啥都没写。

### 三、测试配置管理 ###

#### 3.1 zookeeper上做配置 ####

上面配置的welcom.value，是通过zkui的import导入的文件。

文件内容如下：

/config/zkConfig,dev=welcom.value=test224233

#### 3.2 启动类 ####

启动类就是普通的Springboot启动，无需其他注解。

ZkConfigApplication ：

package cn.pomit.springbootwork.zkconfig;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class ZkConfigApplication { 
    	public static void main(String[] args) { 
    		SpringApplication.run(ZkConfigApplication.class, args);
    	}
    }

#### 3.3 测试配置变更逻辑 ####

我们使用@Value("$\{welcom.value\}")来注入3.1中配置的welcom.value属性。并在类上加@RefreshScope注解。

*  **我们可以将welcom.value属性写入配置文件中，但要注意，配置中心的配置优先级高于本地配置文件**
 *  **如果本地配置文件不存在，配置中心也没有，启动会报错的**
 *  **注意，需要变更配置的类上，要加@RefreshScope注解，否则不会刷新配置。**
 *  **通过接口查询当前的welcom.value值，zookeeper变更配置以后，接口能立即查到变更后的值。**

ConfigInfoService ：

package cn.pomit.springbootwork.zkconfig.service;
    
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.cloud.context.config.annotation.RefreshScope;
    import org.springframework.stereotype.Service;
    
    @RefreshScope
    @Service
    public class ConfigInfoService { 
    
    	@Value("${welcom.value}")
    	private String welcomValue;
    
    	public String testValue() { 
    		System.out.println(welcomValue);
    
    		return welcomValue;
    	}
    
    	public String getWelcomValue() { 
    		return welcomValue;
    	}
    
    	public void setWelcomValue(String welcomValue) { 
    		this.welcomValue = welcomValue;
    	}
    
    }

#### 3.4 测试Web ####

ZkConfigRest :

package cn.pomit.springbootwork.zkconfig.web;
    
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.RestController;
    
    import cn.pomit.springbootwork.zkconfig.model.ResultModel;
    import cn.pomit.springbootwork.zkconfig.service.ConfigInfoService;
    
    @RestController
    @RequestMapping("/zkConfigApi")
    public class ZkConfigRest { 
    	@Autowired
    	ConfigInfoService configInfoService;
    
    	@RequestMapping(value = "/value", method = {  RequestMethod.GET })
    	public ResultModel value() { 
    		return ResultModel.ok(configInfoService.testValue());
    	}
    }

### 四、过程中用到的实体 ###

过程中用到了ResultModel实体，是和上一篇中的实体对应的，作为统一的实体来用。

ResultModel:

详细完整的代码，可以访问[品茗IT-博客《SpringCloud技术指南系列（九）配置管理之Zookeeper配置中心》][IT-]进行查看

[品茗IT-博客专题:https://www.pomit.cn/lecture.html][IT-_https_www.pomit.cn_lecture.html]汇总了[Spring专题][Spring]、[Springboot专题][Springboot]、[SpringCloud专题][SpringCloud]、[web基础配置][web]专题。

### 快速构建项目 ###

Spring项目快速开发工具：

[一键快速构建Spring项目工具][Spring 1]

[一键快速构建SpringBoot项目工具][SpringBoot 1]

[一键快速构建SpringCloud项目工具][https_www.pomit.cn_java_spring_springcloud.html]

[一站式Springboot项目生成][Springboot 1]

[Mysql一键生成Mybatis注解Mapper][Mysql_Mybatis_Mapper]

[Spring组件化构建][Spring 1]

[SpringBoot组件化构建][SpringBoot 1]

[SpringCloud服务化构建][https_www.pomit.cn_java_spring_springcloud.html]

喜欢这篇文章么，喜欢就加入我们一起讨论SpringBoot使用吧！  
![品茗IT交流群][IT]

[SpringBoot]: https://www.pomit.cn/p/2111732768074241
[SpringCloud_Consul]: https://www.pomit.cn/p/2110739747924481
[https_www.pomit.cn_java_spring_springcloud.html]: https://www.pomit.cn/java/spring/springcloud.html
[IT-]: https://www.pomit.cn/p/2118505534671361
[java]: https://jq.qq.com/?_wv=1027&k=52sgH1J
[Web_ Zookeeper]: https://www.pomit.cn/p/2023446285847041
[https_www.pomit.cn_spring_SpringCloudWork_pom.xml]: https://www.pomit.cn/spring/SpringCloudWork/pom.xml
[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly93d3cucG9taXQuY24vdXBsb2FkL3BpY3R1cmUvMjAxOTA4MjIvMjExODUwMzI4NjIxMzEyLnBuZw?x-oss-process=image/format,png
[IT-_https_www.pomit.cn_lecture.html]: https://www.pomit.cn/lecture.html
[Spring]: https://www.pomit.cn/lecture/springunion.html
[Springboot]: https://www.pomit.cn/lecture/springbootfull.html
[SpringCloud]: https://www.pomit.cn/lecture/springcloudfull.html
[web]: https://www.pomit.cn/lecture/webbasics.html
[Spring 1]: https://www.pomit.cn/java/spring/spring.html
[SpringBoot 1]: https://www.pomit.cn/java/spring/springboot.html
[Springboot 1]: https://www.pomit.cn/java/java/sqlToSpringboot.html
[Mysql_Mybatis_Mapper]: https://www.pomit.cn/java/java/sqlToMybatis.html
[IT]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91cGxvYWQtaW1hZ2VzLmppYW5zaHUuaW8vdXBsb2FkX2ltYWdlcy8xNTI5NjcwNS1hYTk5Mzc4ZGZhM2I3ZmJkLnBuZw