【转】 SpringCloud系列——Config 配置中心

【转】 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=1112
spring.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

#连接GitHub
spring.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
@SpringBootApplication
public 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-8
spring.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=10087
spring.application.name=myspringboot

#eureka
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
#超时时间
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=10087
spring.application.name=myspringboot

#eureka
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
#超时时间
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
@RestController
public 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，值已经取到了

　　其实客户端（Config Client）也是可以读取服务端（Config Server）配置文件里面的值，例如：

　　客户端（Config Client）是可以读取到这个值的，由此可见，是客户端是读取了服务端的数据，而服务端负责实时获取GitHub上面的数据

　　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
@RestController
public 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，配置上去的时候发现报错，波浪线，被弃用了，

　　最后还是靠Google，在知乎（https://zhuanlan.zhihu.com/p/34784934）上面找到了答案

　　

　　并且吐槽吐槽百度：

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

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

　　代码开源

　　代码已经开源、托管到我的GitHub、码云：

　　GitHub：https://github.com/huanzi-qch/springCloud

　　码云：https://gitee.com/huanzi-qch/springCloud