注解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)
　　　])