文档首页

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.stereotype.Component;

@Component
@RefreshScope
@ConfigurationProperties(prefix="provider.config")
public class ProviderNameConfig {
    private String name = "echo-provider-default-name";

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

使用 @Value 注解

在启动类ProviderApplication中，使用@Value注解来标识一个配置变量。下面的示例中${test.demo.prop:default}中test.demo.prop是在动态配置下发中使用的 key，value 默认是default 。

使用@RefreshScope注解开启 refresh 机制。

// 其他 import 
import org.springframework.web.bind.annotation.RestController;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.RequestMapping;

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

    @Value("${test.demo.prop:default}")
    private String propFromValue;

    @RequestMapping("/hello/") public String index() {
        String result = "propFromValue: " + propFromValue + "\n";
        return result;
    }                
}

配置更新触发回调

配置更新触发回调功能允许程序在不重启的情况下动态修改业务逻辑。当配置更新时，触发配置回调方法的调用。配置更新触发回调功能的使用场景包括：

程序使用一个防刷开关配置，当开关为启用状态时，启动防刷逻辑，当开关为关闭状态时，停用防刷逻辑。
程序使用一个ReidsConfig的动态配置类，包含 redis 的 host 和 port，当更新这个配置时，更新 Redis 实例。
配置更新后发出通知消息，通知本地或者远程的其他模块执行变更逻辑

TSF 分布式配置支持使用@ConfigChangeListener注解且实现ConfigChangeCallback接口。在SimpleConfigurationListener类中，设置callback回调方法。支持场景包括：

支持按照配置项前缀模糊匹配方式。
支持配置项精确匹配方式。
支持回调方法同步 sync 或者异步 async 方式执行。

// prefix： 配置信息前缀，前缀匹配
// async: 回调事件是否异步执行，默认 false
// value： 精确匹配配置项
// 监听前缀为 io 的配置项变更
@ConfigChangeListener(prefix = "io",async = true)
public class SimpleConfigurationListener implements ConfigChangeCallback {
    @Autowired
    private SimpleService simpleService;
    @Override
    public void callback(ConfigProperty lastConfigItem, ConfigProperty currentConfigItem) {
        simpleService.saySomething("receive Consul Config Change Event >>>> ");
        simpleService.saySomething("Last config: [" + currentConfigItem.getKey()  + ":" +lastConfigItem.getValue() + "]");
        simpleService.saySomething("Current config: [" + currentConfigItem.getKey()  + ":" +currentConfigItem.getValue() + "]");
    }
}
@Component
public class SimpleService {
    public void saySomething(String words){
        System.out.println(words);
    }
}

轻量级服务注册中心下发动态配置

用户可以使用轻量级服务注册中心下发动态配置，下面以 provider-demo 为例说明更新的具体步骤：

前提条件：

已完成轻量级服务注册中心的安装和启动（参考【轻量级服务注册中心】）。
服务已连接到轻量级服务注册中心。

操作步骤

浏览器访问 consul 控制台（http://127.0.0.1:8500）。

注意：

只有成功启动了 consul 后，才能访问 consul 控制台。

单击菜单栏【Key/Value】。
单击【Create】，在配置新建界面填写 key 和 value。

key 是 /config/application/data 或 /config/application/{spring.profiles.active}/data （适用于原生 Spring Cloud）
value 是配置的内容，截图中使用 provider-demo 中的自定义配置 provider.config.name=testname123。

单击【Save】，观察 stdout 中是否出现[TSF SDK] Configuration Change Listener: key: {}, old value: null, new value: testname123，如果出现说明配置生效。

TSF控制台下发动态配置

用户可以通过 TSF 控制台来下发动态配置。

前提条件

已经在 TSF 平台上部署了provider-demo和consumer-demo应用。
部署 provider-demo 的部署组的日志配置项的日志路径中包含了/tsf-demo-logs/provider-demo/root.log，以确保打印的日志被采集后，可以通过控制台查看应用的日志。参考[日志配置项]。

操作步骤

关于如何通过控制台创建及下发更新的配置，请参考【应用配置】。

如果希望修改ProviderNameConfig类中的providerName的值，创建配置时，配置内容填写：

provider:
  config:
    name: testname123

将配置发布到已部署provider-demo的部署组上，检查打印的日志中是否 name 的值已更新。如果已更新，说明更新的配置生效。

provider-demo -- provider config name: testname123