@ConfigurationProperties和@Bean
@ConfigurationProperties也可以和@Bean一起使用如下所示:
@Data
public class Item {
private String name;
private int size;
}
看下怎么使用:
@Data
@Configuration
public class BeanConfigProperties {
@Bean
@ConfigurationProperties(prefix = "item")
public Item item() {
return new Item();
}
}
属性验证
@ConfigurationProperties可以使用标准的JSR-303格式来做属性验证。我们举个例子:
@Data
@Validated
@Configuration
@ConfigurationProperties(prefix = "mail")
public class ConfigProperties {
@NotEmpty
private String hostName;
@Min(1025)
@Max(65536)
private int port;
@Pattern(regexp = "^[a-z0-9._%+-]+@[a-z0-9.-]+.[a-z]{2,6}$")
private String from;
}
如果我们的属性不满足上诉条件,可能出现如下异常:
Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'mail' to com.flydean.config.ConfigProperties$$EnhancerBySpringCGLIB$$f0f87cb9 failed: Property: mail.port Value: 0 Reason: 最小不能小于1025 Property: mail.hostName Value: null Reason: 不能为空 Action: Update your application's configuration Process finished with exit code 1
属性转换
@ConfigurationProperties也支持多种属性转换,下面我们以Duration和DataSize为例:
我们定义两个Duration的字段:
@ConfigurationProperties(prefix = "conversion")
public class PropertyConversion {
private Duration timeInDefaultUnit;
private Duration timeInNano;
...
}
在属性文件中定义这两个字段:
conversion.timeInDefaultUnit=10 conversion.timeInNano=9ns
我们看到上面的属性可以带单位的。可选的单位是:ns, us, ms, s, m, h 和 d,分别对应纳秒,微妙,毫秒,秒,分钟,小时和天。默认单位是毫秒。我们也可以在注解中指定单位:
@DurationUnit(ChronoUnit.DAYS) private Duration timeInDays;
对应的配置文件如下:
conversion.timeInDays=2
下面我们再看看DataSize怎么使用:
private DataSize sizeInDefaultUnit; private DataSize sizeInGB; @DataSizeUnit(DataUnit.TERABYTES) private DataSize sizeInTB;
对应的属性文件:
conversion.sizeInDefaultUnit=300 conversion.sizeInGB=2GB conversion.sizeInTB=4
Datasize支持B, KB, MB, GB 和TB。
自定义Converter
同样的Spring Boot也支持自定义属性转换器。我们先定义一个POJO类:
public class Employee {
private String name;
private double salary;
}
对应的属性文件:










