springboot 中yml配置

springboot 中各种配置项纪录

0. 20210309 更新

@value 和 @ConfigurationProperties 绑定机制不一样,@Value 配置在 yml 中时 list 无法根据 逗号 “,” 来分割数据,在 properties 文件里可以使用。

如果需要yml配置直接获取,需要用到 spEL 表达式,如

/**
 * 注入列表形式(自动根据"|"分割)
 */
@Value("#{'${str1}'.split(',')}")
private List<String> str1;

更新:spring 5 之后,对于@value 在 yml 中,也可以完成list 按照 逗号分隔注入,无需额外的 SpEL 支持

1. @Value

最早获取配置文件中的配置的时候,使用的就是这个注解,SpEL表达式语言。

// 使用起来很简单
@Value("${config.demo.value:defaultValue}")
  private String simpleValue;
  

2. @ConfigurationProperties

通常我们配置的时候,不仅仅是一个单独字段,可能是一组配置,用来组成一个对象。这个时候spring为我们提供了这个注解。

简单的对象,在yml里也可以很简单的写出来。直接把每一个字段写出即可。

而对复杂对象,如:list、map等的,就需要查一下资料了,这里简单记录一下写法,直接看代码。

# 配置示例
config:
  demo:
    value: testValue

    simpleConfig:
      config: testConfig

    str1: abc,cde
    str2:
      - abc
      - cde

    configMap:
      key1: value1
      海贼王: 路飞

    simpleConfigs:
      - config: 罗宾
        count: 1
      - config: 乌索普
        count: 1
      - config: 索隆
        count: 1

    configObjMap:
      key1:
        config: value1
      key2:
        config: value2

pojo 对象定义如下:

@Data
@ConfigurationProperties(prefix = "config.demo")
@Configuration
public class ConfigDemo {
  @Value("${config.demo.value:defaultValue}")
  private String simpleValue;

  /**===========简单对象===========*/
  /**
   * 对象
   */
  private SimpleConfig simpleConfig;
  /**
   * 字符串数组1
   */
  private List<String> str1;
  /**
   * 字符串数组1
   */
  private List<String> str2;
  /**
   * 键值对
   */
  private Map<String, String> configMap;

  /**
   * ===========多个复杂对象==========
   */
  /**
  	* 对象集合
  	*/
  private List<SimpleConfig> simpleConfigs;
  /**
  * 对象作为map值
  */
  private Map<String, SimpleConfig> configObjMap;


  @Data
  public static class SimpleConfig {  // 注意:这里需要内部类是public的,要不然注入的时候会出错。
    private String config;
    private int count;
  }
}

以上就是各种情况的书写。其实也不难,list 就增加 - 来作为单个对象标识,而map就直接写key即可。

而spring在存储properties的时候是怎么处理的呢,我们可以断点一下 PropertyPlaceholderHelper,在这里我们可以看到存储各种配置的source如下图:

底层都是通过一个ResourceReloadingMap来存储的,那么存储list的时候,是什么结构呢,如下:

// 存储的时候是这样的:

simpleConfigs[0].config=configValue
simpleConfigs[0].count=countValue
...

所以最终都是通过键值对的方式,只是对应的格式,spring可以解析成对应的样子而已。

3. 参考

SpringBoot之Spring@Value属性注入使用详解

posted @ 2020-07-03 18:48  爬行  阅读(1458)  评论(0编辑  收藏  举报