如何对SpringConfig的配置项执行修改或持久化_应用高可用服务-阿里云帮助中心

本文介绍如何对Spring Config的配置项执行修改或者持久化等操作。

前提条件

接入应用：

Agent方式接入，与流量防护共用Agent，配置-Dahas.switch.agent.plugin.group.enabled=true。
应用配置SDK方式接入。具体操作，请参见使用SDK接入。
应用配置Spring Boot Starter方式接入。具体操作，请参见使用Spring Boot Starter接入。

背景信息

Spring Demo文件：

UserController类对象：为@Value配置，用于测试@PostConstruct注解，此阶段可识别持久化值，部分内容如下。

@RestController
public class UserController {

    @Value("${project.name}")
    public String name;

    @Value("${user.ahas}")
    public boolean ahas;

    @Value("${user.number}")
    public int num;

    @Value("${destination}")
    public String destinationStr;


    @Autowired
    private Destination destination;

    @PostConstruct
    private void init(){
        System.out.println("[UserController] init()  value: "+ destinationStr +" , " + num + " , "+ ahas + " , " + name);
        System.out.println("[UserController] init()  configuration: "+destination.getAvg()+" , " + destination.getMax() + " , "+ destination.getMin());
    }
}

DemoConfig类对象：为@Value配置，用于测试InitializingBean，afterPropertiesSet函数，初始化阶段可读取到持久化值，内容如下。

@Configuration
public class DemoConfig implements InitializingBean {
    @Autowired
    private RequestProperties requestProperties;

    @Override
    public void afterPropertiesSet() {
        System.out.println("[DemoConfig] init()  port: " + requestProperties.getPort() + " ,interface: " + requestProperties.getInter());
    }

}

RequestProperties类对象：为@ConfigurationProperties配置，Value模式。

@Component
@ConfigurationProperties(value = "request")
public class RequestProperties {
    private int port;

    private String inter;

    public int getPort() {
        return port;
    }

    public void setPort(int port) {
        this.port = port;
    }

    public String getInter() {
        return inter;
    }

    public void setInter(String inter) {
        this.inter = inter;
    }
}

Destination类对象：为@ConfigurationProperties配置，Prefix模式。

@Component
@ConfigurationProperties(prefix = "property.destination")
public class Destination {
    private int max;
    private int min;
    private int avg;

    public int getMax() {
        return max;
    }

    public void setMax(int max) {
        this.max = max;
    }

    public int getMin() {
        return min;
    }

    public void setMin(int min) {
        this.min = min;
    }

    public int getAvg() {
        return avg;
    }

    public void setAvg(int avg) {
        this.avg = avg;
    }
}

application.properties配置内容如下。

user.ahas=false
user.number=123

request.port=8081
request.inter=/hello

destination=sun

property.destination.max=300
property.destination.min=10
property.destination.avg=100

查看应用的开关配置

登录 AHAS控制台，然后在页面左上角选择地域。
在左侧导航栏选择功能开关，在应用列表页面可看到已接入的应用。
单击目标应用卡片，然后单击分组模式。

如下图所示，可看到以分组形式展示的开关配置项。其中各分组名为识别出的类名，开关名为类中字段名，描述内容为@Value方式（注解中的内容）或者@ConfigurationProperties方式（Spring配置文件）的配置项，具体请参见背景信息中的介绍。

开关配置值的修改

对开关配置值的修改分为单机推送和全局推送两种方式。单机推送的值不会持久化，仅当前微服务实例生命周期有效；全局推送方式会进行值持久化，微服务实例再次启动后可看到持久化值。

单机推送

例如，对RequestProperties类对象中的port字段执行单机推送。

推送后应用中的deport字段的值已被修改，可在控制台中查看推送结果。

同样的方式，您还可以对UserController类对象中num的字段执行单机推送。您可在历史记录中查看历史推送操作。具体操作，请参见查看历史推送记录。

全局推送

例如，对Destination类对象中的max字段执行全局推送。

推送后应用中的max字段已被修改，同时数据已经持久化，可在控制台中查看推送结果。

同样的方式，您还可以对UserController类对象中的destinationStr字段执行全局推送。

开关配置值的持久化验证

初始化阶段

重启应用，在InitializingBean，afterPropertiesSet函数初始化阶段与@PostConstruct初始化阶段均可被读取到已持久化的值。

可通过测试Demo中的启动日志查看，内容如下：

@ConfigurationProperties配置

在控制台可看到通过全局推送方式推送的RequestProperties类对象的inter字段的配置项为持久化值，而通过单机推送的port字段的配置项仍为Spring原始配置内容。

@Value配置

在控制台可看到通过全局推送方式推送的UserController类对象的destinationStr字段的配置项为持久化值，而通过单机推送的num字段的配置项仍为Spring原始配置内容。

查看历史推送记录

登录 AHAS控制台，然后在页面左上角选择地域。
在控制台左侧导航栏选择功能开关，在应用列表页面单击目标应用的资源卡片。进入目标应用的开关列表页面。
在开关列表页面选择System页签，然后单击右上角的历史记录，可查看以往所有的推送记录。

日志动态调整

测试样例如下：

 private static final Random RANDOM = new Random();
 private static final Logger logger = LoggerFactory.getLogger("xx");

    @GetMapping("/hello")
    public ResponseEntity<String> hello(){
        int random = RANDOM.nextInt(100);
        logger.info("[SystemLog] ------------------- info : {} ",random);
        logger.debug("[SystemLog] ------------------- debug : {} ",random);
        logger.error("[SystemLog] ------------------- error : {} ",random);
        if(random < 30) {
            return new ResponseEntity<String>("BAD", HttpStatus.BAD_REQUEST);
        } else if(random > 50) {
            return new ResponseEntity<String>("BAD", HttpStatus.SERVICE_UNAVAILABLE);
        } else {
            return new ResponseEntity<String>("OK", HttpStatus.OK);
        }
    }

设置日志级别。
1. 在开关列表页面选择System页签，然后在搜索框中搜索 SYSTEM_LOG_CONFIG 开关，即日志级别开关。
2. 单击操作列的单击推送或右上角的全局推送，按照 <loggerName,loggerLevel> 格式填写日志运行的配置，然后单击全局推送或单机推送。即可修改全部机器或是单台机器的日志运行级别。这里以全局方式为例。
  推送值格式：Key 为 LoggerName，Value 为日志级别。如需修改全局日志级别，LoggerName 为 root，如下所示。
```
{
 "root": "ERROR"
}
```
查看日志打印情况。
若将日志级别设为“DEBUG”，则日志打印结果如下：

灰度推送

您还可以在控制台设置开关的灰度推送。

在目标开关的右上角单击全局推送，进入开关推送页面，在此页面中编辑推送值。
单击左下角的灰度推送，在弹出的灰度推送设置页面，设置灰度批次，选择是否多次暂停。然后单击开始灰度。
灰度推送成功后，在开关推送的进度列会显示已完成。