SpringCloud系列——Config 配置中心

前言

　　Spring Cloud Config为分布式系统中的外部化配置提供了服务器端和客户端支持。有了配置服务器，您就有了一个中心位置来管理跨所有环境的应用程序的外部属性。本文记录实现一个配置中心、客户端获取配置参数、refresh手动刷新

　　官方文档：https://cloud.spring.io/spring-cloud-config/single/spring-cloud-config.html

　　帮助文档：https://spring.io/guides/gs/centralized-configuration/

 

　　Config Server

　　首先我们基于之前的代码，在springCloud工程下面新建一个Config Server，是一个springboot项目，并且在Eureka上面注册服务（还不会服务注册与发现的，请戳：SpringCloud系列——Eureka 服务注册与发现），本例使用的是GitHub

　　maven引jar

        <!-- config-server -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-config-server</artifactId>
        </dependency>

　　登录GitHub，新建一个public仓库：config-server，并且添加测试项目对应的配置文件：myspringboot-dev.properties，并设置几个值

　　配置文件

server.port=1112spring.application.name=config-server
eureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/#健康检查（需要spring-boot-starter-actuator依赖）eureka.client.healthcheck.enabled=true# 续约更新时间间隔（默认30秒）eureka.instance.lease-renewal-interval-in-seconds=10# 续约到期时间（默认90秒）eureka.instance.lease-expiration-duration-in-seconds=10#连接GitHubspring.cloud.config.server.git.uri=https://github.com/huanzi-qch/config-server.git
spring.cloud.config.server.git.search-paths=config-server
spring.cloud.config.label=master
spring.cloud.config.server.git.username=******spring.cloud.config.server.git.password=******

　　启动类加入注解@EnableConfigServer

@EnableConfigServer
@EnableEurekaClient
@SpringBootApplicationpublic class ConfigServerApplication {    public static void main(String[] args) {
        SpringApplication.run(ConfigServerApplication.class, args);
    }
}

 　　启动项目，访问http://localhost:1112/myspringboot-dev.properties/，发现有中文乱码

　　注：仓库中的配置文件会被转换成web接口，访问规则：

• /{application}/{profile}[/{label}]

• /{application}-{profile}.yml

• /{label}/{application}-{profile}.yml

• /{application}-{profile}.properties

• /{label}/{application}-{profile}.properties

　　解决中文乱码，参考：https://blog.csdn.net/sinat_38843093/article/details/79960777

　　新建自定义解析器MyPropertiesHandler，继承PropertiesPropertySourceLoader，重写方法

/**
 * 解决中文乱码问题
 * 参考：https://blog.csdn.net/sinat_38843093/article/details/79960777
 */public class MyPropertiesHandler extends PropertiesPropertySourceLoader {

    @Override    public String[] getFileExtensions() {        return new String[]{"properties", "xml"};
    }

    @Override    public List<PropertySource<?>> load(String name, Resource resource) throws IOException {
        ArrayList<PropertySource<?>> list = new ArrayList<>();
        Properties properties = getProperties(resource);        if (!properties.isEmpty()) {
            list.add(new PropertiesPropertySource(name, properties));
        }        return list;
    }    private Properties getProperties(Resource resource) throws IOException {
        Properties properties = new Properties();
        InputStream inputStream = resource.getInputStream();
        properties.load(new InputStreamReader(inputStream, StandardCharsets.UTF_8));
        inputStream.close();        return properties;
    }
}

　　resources文件夹下面新建META-INF文件夹，在里面创建spring.factories文件，指定使用我们自定义的解析器

org.springframework.boot.env.PropertySourceLoader=cn.huanzi.qch.config.configserver.MyPropertiesHandler

　　重新启动项目，在自定义解析器后进行断点调试，发现解析的时候中文乱码问题得以解决，但响应回去还是乱码

　　解决http响应中文乱码问题

　　配置文件添加

#解决http响应数据中文乱码问题spring.http.encoding.force=true
spring.http.encoding.charset=UTF-8spring.http.encoding.enabled=true
server.tomcat.uri-encoding=UTF-8

　　最终效果

 　　我们去GitHub修改配置中心的值，看下config server能不能实时获取最新数据

　　改完后刷新http://localhost:1112/myspringboot-dev.properties/，配置中心可以实时获取最新数据

 

 

　　Config Client

　　客户端我们直接用之前的项目：myspringboot，这里就当做一个在Eureka上注册了的普通springboot项目

　　maven引入jar

        <!-- config-client -->
        <dependency>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-config</artifactId>
        </dependency>

　　application.properties

#设置服务端口server.port=10087spring.application.name=myspringboot#eurekaeureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/#健康检查（需要spring-boot-starter-actuator依赖）eureka.client.healthcheck.enabled=true# 续约更新时间间隔（默认30秒）eureka.instance.lease-renewal-interval-in-seconds=10# 续约到期时间（默认90秒）eureka.instance.lease-expiration-duration-in-seconds=10#超时时间feign.httpclient.connection-timeout=30000

　　使用优先级更高的bootstrap.properties进行config的配置，因为

#关闭spring cloud config，spring cloud默认要从config中读取配置，通过该配置，只从本地application.properties中读取配置
#spring.cloud.config.enabled=false

#配置文件名（当应用名跟配置文件相同时可以不用配置）spring.cloud.config.name=myspringboot# dev 开发环境配置文件 |  test 测试环境  |  pro 正式环境spring.cloud.config.profile=dev# 远程仓库的分支spring.cloud.config.label=master#指定配置中心名称（如果使用eureka可以这样配置）
#spring.cloud.config.discovery.service-id=config-server
#启用发现服务功能
#spring.cloud.config.discovery.enabled=true

#配置服务中心地址（如果不使用eureka可以直接配置url路径）spring.cloud.config.uri=http://localhost:1112/

　　如果使用从eureka获取配置中心实例，则要在指定服务之前进行注册配置，否则会报错，因为你还没在Eureka注册就去Eureka查找配置中心，如：

#设置服务端口server.port=10087spring.application.name=myspringboot#eurekaeureka.client.serviceUrl.defaultZone=http://localhost:1111/eureka/#健康检查（需要spring-boot-starter-actuator依赖）eureka.client.healthcheck.enabled=true# 续约更新时间间隔（默认30秒）eureka.instance.lease-renewal-interval-in-seconds=10# 续约到期时间（默认90秒）eureka.instance.lease-expiration-duration-in-seconds=10#超时时间feign.httpclient.connection-timeout=30000#关闭spring cloud config，spring cloud默认要从config中读取配置，通过该配置，只从本地application.properties中读取配置
#spring.cloud.config.enabled=false

#配置文件名（当应用名跟配置文件相同时可以不用配置）spring.cloud.config.name=myspringboot# dev 开发环境配置文件 |  test 测试环境  |  pro 正式环境spring.cloud.config.profile=dev# 远程仓库的分支spring.cloud.config.label=master#指定配置中心名称（如果使用eureka可以这样配置）spring.cloud.config.discovery.service-id=config-server#启用发现服务功能spring.cloud.config.discovery.enabled=true#配置服务中心地址（如果不使用eureka可以直接配置url路径）
#spring.cloud.config.uri=http://localhost:1112/

　　测试

　　我们直接在启动类进行测试

@EnableEurekaClient
@SpringBootApplication
@RestControllerpublic class MyspringbootApplication{    public static void main(String[] args) {
        SpringApplication.run(MyspringbootApplication.class, args);
    }

    @Value("${huanzi.qch.config.server.username}")    private String username;    /**
     * 访问首页     */
    @GetMapping("/index")    public String index(){        return "hello springboot！username：" + username;
    }

}

　　查看启动日志，客户端已经发现了配置中心，并且从配置中心发现了myspringboot配置文件

　　访问http://localhost:10087/index，值已经取到了

 

　　refresh手动刷新

　　我们已经在客户端取到了配置中心的值，但当我们修改GitHub上面的值时，服务端（Config Server）能实时获取最新的值，但客户端（Config Client）读的是缓存，无法实时获取最新值

　　spring已经为我们解决了这个问题，那就是客户端使用post去触发refresh，获取最新数据，需要依赖spring-boot-starter-actuator

        <!-- actuator -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-actuator</artifactId>
        </dependency>

　　对应的controller类加上@RefreshScope

@RefreshScope
@EnableEurekaClient
@SpringBootApplication
@RestControllerpublic class MyspringbootApplication{    public static void main(String[] args) {
        SpringApplication.run(MyspringbootApplication.class, args);
    }

    @Value("${huanzi.qch.config.server.username}")    private String username;    /**
     * 访问首页     */
    @GetMapping("/index")    public String index(){        return "hello springboot！username：" + username;
    }

}

　　启动后查看日志发现，actuator有个基础路径/actuator，同时还暴露了两个终端（不知道是哪两个端点...）

　　但是当我们post访问http://localhost:10087/actuator/refresh时，报404，这是什么回事？

　　注：这里插一句话：从网上找了个js的ajax（要注意content-type的类型）

var Ajax={
  get: function(url, fn) {    // XMLHttpRequest对象用于在后台与服务器交换数据
    var xhr = new XMLHttpRequest();            
    xhr.open('GET', url, true);
    xhr.onreadystatechange = function() {      // readyState == 4说明请求已完成
      if (xhr.readyState == 4 && xhr.status == 200 || xhr.status == 304) { 
        // 从服务器获得数据
        fn.call(this, xhr.responseText);  
      }
    };
    xhr.send();
  },  // datat应为'a=a1&b=b1'这种字符串格式，在jq里如果data为对象会自动将对象转成这种字符串格式
  post: function (url, data, fn) {    var xhr = new XMLHttpRequest();
    xhr.open("POST", url, true);    // 添加http头，发送信息至服务器时内容编码类型
    xhr.setRequestHeader("Content-Type", "application/json");  
    xhr.onreadystatechange = function() {      if (xhr.readyState == 4 && (xhr.status == 200 || xhr.status == 304)) {
        fn.call(this, xhr.responseText);
      }
    };
    xhr.send(data);
  }
}

Ajax.post("http://localhost:10087/actuator/refresh",null,function(data){console.log(data)})

　　经过层层查找，最后在帮助文档发现：默认情况下，自Spring Boot 2.0以来，默认情况下不会公开Actuator端点，需要手动暴露端点

　　配置文件暴露端点

#只暴露refresh，当然也可以暴露所有：=*management.endpoints.web.exposure.include=refresh

　　重启客户端，我们将GitHub配置文件改回：huanzi.qch.config.server.username: 张三

　　访问测试接口，还是张三1

　　post调用refresh

　　刷新，数据更新

 

　　总结

　　这里总结一下遇到的坑：

　　调用refresh报404的时候，百度查找都是说默认安全拦截，配置关闭：management.security.enabled=false，配置上去的时候发现报错，波浪线，被弃用了，最后还是靠科学上网，在知乎（https://zhuanlan.zhihu.com/p/34784934）上面找到了答案

　　

　　并且吐槽吐槽百度：

　　同样的关键字，Google搜出来的第一个就能解决问题 

　　而垃圾百度，没一个可以...

作者：huanzi-qch

出处：https://www.cnblogs.com/huanzi-qch/p/10149547.html  

若标题中有“转载”字样，则本文版权归原作者所有。若无转载字样，本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利.