注解ConfigurationProperties注入yml配置文件中的数据

在使用SpringBoot开发中需要将一些配置参数放在yml文件中定义，再通过Java类来引入这些配置参数

SpringBoot提供了一些注解来实现这个功能

• ConfigurationProperties
• Value
• EnableConfigurationProperties

下面提供例子来说明如何引入常规变量，数组，List，Ｍap,引用对象。

[相关代码-ＧitHub]

引入pom

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
</dependency>

<dependency>
     <groupId>org.springframework.boot</groupId>
     <artifactId>spring-boot-configuration-processor</artifactId>
      <optional>true</optional>
</dependency>

<!--lombok 插件，非必须 -->
 <dependency> 
　　　<groupId>org.projectlombok</groupId> 
　　　<artifactId>lombok</artifactId> 
　　　<optional>true</optional> 
</dependency>

注解类

这里定义了一个全局的注解类，

@Data
@ToString
@ConfigurationProperties(prefix = "all")
public class AllConfigurationProperties {

    //普通变量
    private  String name;
　　 //引用对象
    private  OtherProperties other = new OtherProperties();
    //数组
    private  String[] server;
   //list
    private List list;
    //map
    private Map map;
   //复杂map
    private Map<String, ModuleConfig> modules = new LinkedHashMap();
   //复杂list
    private List<ModuleConfig> modulesList;

}

ConfigurationProperties:标明者是一个配置类，需要prefix配置yml中的配置前缀。

需要注意几点
１. 配置类中的名称应当符合JavaＢean的命名方式
2.　配置类中的名称应当与yml中的相同，否则应使用@Value指定
比如：

yml文件：

all:
　　name: libai
------------------------------------

＠Ｖalue("${all.name}")
private String myName;

3. 如果已经使用@Value方式，可不用写Setter方法。否则必须为该变量写Setter方法，这里使用lombok的注解@Data来配置，会自动生成Ｓetter,Getter,ToString方法

4. 默认值设置：
　　（１）当使用@Value时，可以通过如下方式实现

     　　@Value("${nzrpc.netty.port:8321}")

     　　private int nport;

　　　　　当yml没有配置nzrpc.netty.port　时，默认值便是8321

　　(2) 或者是直接对变量赋值
　　　　private int nport　＝　8321　;

　　　　private  OtherProperties other = new OtherProperties();

上述配置类的引用对象

@Data
public class ModuleConfig {
    private static final long serialVersionUID = 5508512956753757169L;
    private String name;
    private String version;
    private String owner;
}

@Data
public class OtherProperties {

    private  Long id;
    private String version;
}

使能配置类

@Slf4j
@EnableConfigurationProperties(AllConfigurationProperties.class)
@Configuration
public class AutoConfiguration {

    @Autowired
    AllConfigurationProperties properties;

    @PostConstruct
    public void  init(){

        System.out.println("properties = " + properties);

    }

}

这里使用@EnableConfigurationProperties使能配置类。它会为AllConfigurationProperties注入yml中的配置参数，并创建一个bean，后续可使用@Autowired注入使用

@Configuration注明这是一个SpringＢoot的配置类

使用方法init()输出配置.

yml中配置

all:
  name: libai
  other:
    id: 100
    version: 1.0.1

  server:
    - 127.0.0.1
    - 127.0.0.2
    - 127.0.0.3

  list:
    - 111
    - 222
    - 333

  map:
    key1: value1
    key2: value2
    key3: value3

  modules:
    key1:
      name: modules-name-1
      version: modules-version-1
      owner: modules-owner-1
    key2:
      name: modules-name-2
      version: modules-version-2
      owner: modules-owner-2

  modulesList:
    - name: modules-name-3
      version: modules-version-3
      owner: modules-owner-3
    - name: modules-name-4
      version: modules-version-4
      owner: modules-owner-4

输出

properties =
 AllConfigurationProperties(
 name=libai, 
 other=OtherProperties(id=100, version=1.0.1),
 server=[127.0.0.1, 127.0.0.2, 127.0.0.3], 
 list=[111, 222, 333],
 map={
　　　key1=value1,
　　　 key2=value2, 
　　　key3=value3
　　　}, 
 modules={
　　　key1=ModuleConfig(name=modules-name-1, version=modules-version-1, owner=modules-owner-1),
　　 key2=ModuleConfig(name=modules-name-2, version=modules-version-2, owner=modules-owner-2)
　　　}, 
 modulesList=[
　　　ModuleConfig(name=modules-name-3, version=modules-version-3, owner=modules-owner-3), 
　　　ModuleConfig(name=modules-name-4, version=modules-version-4, owner=modules-owner-4)
　　　])