dynamic-config-spring-boot


License

License

Categories

Categories

Spring Boot Container Microservices config Application Layer Libs Configuration
GroupId

GroupId

com.purgeteam
ArtifactId

ArtifactId

dynamic-config-spring-boot
Last Version

Last Version

0.1.1.RELEASE
Release Date

Release Date

Type

Type

pom
Description

Description

dynamic-config-spring-boot
dynamic-config-spring-boot
Project URL

Project URL

https://github.com/purgeteam/dynamic-config-spring-boot
Source Code Management

Source Code Management

https://github.com/purgeteam/dynamic-config-spring-boot

Download dynamic-config-spring-boot

How to add to project

<!-- https://jarcasting.com/artifacts/com.purgeteam/dynamic-config-spring-boot/ -->
<dependency>
    <groupId>com.purgeteam</groupId>
    <artifactId>dynamic-config-spring-boot</artifactId>
    <version>0.1.1.RELEASE</version>
    <type>pom</type>
</dependency>
// https://jarcasting.com/artifacts/com.purgeteam/dynamic-config-spring-boot/
implementation 'com.purgeteam:dynamic-config-spring-boot:0.1.1.RELEASE'
// https://jarcasting.com/artifacts/com.purgeteam/dynamic-config-spring-boot/
implementation ("com.purgeteam:dynamic-config-spring-boot:0.1.1.RELEASE")
'com.purgeteam:dynamic-config-spring-boot:pom:0.1.1.RELEASE'
<dependency org="com.purgeteam" name="dynamic-config-spring-boot" rev="0.1.1.RELEASE">
  <artifact name="dynamic-config-spring-boot" type="pom" />
</dependency>
@Grapes(
@Grab(group='com.purgeteam', module='dynamic-config-spring-boot', version='0.1.1.RELEASE')
)
libraryDependencies += "com.purgeteam" % "dynamic-config-spring-boot" % "0.1.1.RELEASE"
[com.purgeteam/dynamic-config-spring-boot "0.1.1.RELEASE"]

Dependencies

provided (1)

Group / Artifact Type Version
org.springframework.boot : spring-boot-configuration-processor Optional jar

Project Modules

  • nacos-spring-boot-starter
  • dynamic-config-spring-boot-starter

dynamic-config-spring-boot SpringCloud-动态配置变化监控-获取变化(支持Config、Nacos)

Maven Central License License License License

🔥 🔥 🔥 相关文档请访问 PurgeTeam docs 🔥 🔥 🔥

简介

配置中心有原生的 SpringCloud Config 、国内开源的 阿里 Nacos、携程 Apollo 等。 都是配置热加载的基础上增加了其他的功能。

配置中心具有配置热加载,修改配置 -> 推送到程序 -> 执行配置更新。

而获取配置更新的具体内容,这些组件都没有做到(SpringCloud ConfigNacos, Apollo待验证 )。如:获取变化的配置 test 更新前为 123 ,更新后为 111

SpringCloud ConfigNacosApollo待验证 配置更新都是将整个配置文件推送给服务进行配置对比结果进行更新。这个阶段用户无法从程序中获取更新的内容。

为了实现这个扩展功能点,更新结果可以让程序感知。 在这个阶段用户通过code可以实现配置监听, 监听到某个配置变化做其他操作等。

示例: 获取到推送配置变化, 感知到 test 发生变化, 做更新同步数据操作等等。

感知结果集如:

{
    `被更新的配置key`:{
        before: `原来的值`,
        after: `更新后的值`
    },
    `被更新的配置key`:{
        before: `原来的值`,
        after: `更新后的值`
    }
}

功能使用

添加依赖

ps: 实际version版本请使用最新版 最新版本: Maven Central

<dependency>
  <groupId>com.purgeteam</groupId>
  <artifactId>dynamic-config-spring-boot-starter</artifactId>
  <version>0.1.0.RELEASE</version>
</dependency>

当然实际情况要结合添加动态配置依赖包 SpringCloud ConfigNacosApollo

dynamic-config-spring-boot-starter 模块不包含以上依赖, 需要自行添加。

@EnableDynamicConfigEvent

简介: 开启这个特性注解,具备配置推送更新监听能力。

启动类添加 @EnableDynamicConfigEvent 注解开启配置变化监听功能。

@EnableDynamicConfigEvent
@SpringBootApplication
public class DynamicConfigSpringBootApplication {

  public static void main(String[] args) {
    SpringApplication.run(DynamicConfigSpringBootApplication.class, args);
  }

}

编写事件接收器

创建 NacosListener(名称随意) 实现 ApplicationListener<ActionConfigEvent>#onApplicationEvent 方法

@Slf4j
@Component
public class NacosListener implements ApplicationListener<ActionConfigEvent> {

  @Override
  public void onApplicationEvent(ActionConfigEvent event) {
    log.info("接收事件");
    log.info(event.getPropertyMap().toString());
  }
}

NacosListener#onApplicationEvent 方法里获取目标值, 作相应的逻辑处理。

ActionConfigEvent event:

public class ActionConfigEvent extends ApplicationEvent {

    // 事件说明
    private String eventDesc;
    
    // 更新变化结果集
    private Map<String, HashMap> propertyMap;
    ...
}

ActionConfigEvent 主要包含 Map<String, HashMap> propertyMap;, 从这里可以获取更新变化结果, propertyMap结构如下:

{
    `被更新的配置key`:{
        before: `原来的值`,
        after: `更新后的值`
    },
    `被更新的配置key`:{
        before: `原来的值`,
        after: `更新后的值`
    }
}

更新配置演示

ps: 示例为 Nacos 其它配置中心无差别。

原始配置:

test.age=18
user.name=purgeyao

修改配置:

# test.age 将18更新为19
test.age=19
user.name=purgeyao

NacosListener#onApplicationEvent 方法加入端点调试观察 ActionConfigEvent 对象参数。

img

更新的 test.age 已经被记录在了 ActionConfigEvent.propertyMap 里了, 从 18 更新为 19。

控制台打印:

2019-10-17 10:44:09.221  INFO 54054 --- [-10.1.1.97_8848] c.p.dynamic.config.demo.NacosListener    : 接收事件
2019-10-17 10:45:19.752  INFO 54054 --- [-10.1.1.97_8848] c.p.dynamic.config.demo.NacosListener    : {test.age={before=18, after=19}}
com.purgeteam

purgeteam

Springboot相关组件简化开发,微信交流群:MercyYao QQ交流群:812321371。Springboot peripherals to simplify development. WeChat ac group:MercyYao QQ ac group:812321371

Versions

Version
0.1.1.RELEASE
0.1.0.RELEASE