Spring Boot: Yaml配置文件 以及 @ConfigurationProperties属性获取

Yaml配置文件

概述

Spring Boot在支持application.properties配置文件的同时,也支持application.yaml配置文件.
配置文件中的属性,能够经过:

• 经过@Value注解将属性值注入Bean中;
• 经过@ConfigurationProperties注解将属性值注入Bean中.

此处不推荐使用@Value方式注入属性,缘由有二:

• 对于较为复杂的数据结构难以设置,诸如Map,Object;
• 不支持对属性值进行校验,诸如@Length,@Size等.

示例

#Simple properties
mail.host=mailer@mail.com
mail.port=9000
mail.from=mailer@mail.com

#List properties
mail.defaultRecipients[0]=admin@mail.com
mail.defaultRecipients[1]=owner@mail.com

#Map Properties
mail.additionalHeaders.redelivery=true
mail.additionalHeaders.secure=true
mail.additionalHeaders.p3=value

#Object properties
mail.credentials.username=john
mail.credentials.password=password
mail.credentials.authMethod=SHA1

以上为application.properties示范配置,下面将使用yaml表示:

#Simple properties
mail:
  host: mailer@mail.com
  port: 9000
  from: mailer@mail.com
#List properties
  defaultRecipients:
    - admin@mail.com
    - owner@mail.com
#Map Properties
  additionalHeaders:
    redelivery: true
    secure: true
    p3: true
#Object properties
  credentials:
    username: john
    password: password
    authMethod: SHA1

经过两份配置文件的比较,我的认为Yaml配置文件经过树形结构更加清晰明了.
两份文件同时展现了List,Map,Object形式配置文件的设置,可供你们参考.

@ConfigurationProperties属性获取

@Getter
@Setter
@Configuration
//@PropertySource("classpath:configprops.properties")
@ConfigurationProperties(prefix = "mail")
@Validated
public class ConfigProperties {

    @Validated
    @Getter
    @Setter
    public static class Credentials {

        @Length(max = 4, min = 1)
        private String authMethod;
        private String username;
        private String password;
    }

    @NotBlank
    private String host;
    @Min(1025)
    @Max(65536)
    private int port;
    @Pattern(regexp = "^[a-z0-9._%+-]+@[a-z0-9.-]+\\.[a-z]{2,6}$")
    private String from;
    private Credentials credentials;
    private List<String> defaultRecipients;
    private Map<String, String> additionalHeaders;
}

上述代码为获取Yaml配置文件中的属性值类,而且使用Configuration将类做为Bean提供给程序使用(能够去除此注解,将属性类型经过@Autowired注解注入Bean中).
注意,此处使用@ConfigurationProperties注解,获取前缀为mail的属性值.

Tips:

• 能够添加注解,对属性值进行校验,诸如@NotBlank,@Pattern等;
• 经过public static class Credentials类,将属性值注入Object对象内;
• 经过@PropertySource注解实现从指定的配置文件读取属性设置.

@Value属性获取

hello.world.name=xiaoming

或者

hello:
  world:
    name: xiaoming

在属性文件中添加以上配置:

@RestController
public class HelloController {

    @Value("${hello.world.name}")
    private String name;
}

在Bean中能够经过@Value获取属性值.
关于@value的文章较多,想深刻了解的同窗能够搜索学习.

pom依赖

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

PS:
若是您以为个人文章对您有帮助，请关注个人微信公众号，谢谢!