这篇文章主要介绍了SpringBoot @ConfigurationProperties使用详解，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
简介
本文将会详细讲解@ConfigurationProperties在Spring Boot中的使用。
添加依赖关系
首先我们需要添加Spring Boot依赖：
org.springframework.bootspring-boot-starter-parent<!-- lookup parent from repository -->
一个简单的例子
@ConfigurationProperties需要和@Configuration配合使用，我们通常在一个POJO里面进行配置：
@Data @Configuration @ConfigurationProperties(prefix = "mail") public class ConfigProperties { private String hostName; private int port; private String from; }
上面的例子将会读取properties文件中所有以mail开头的属性，并和bean中的字段进行匹配：
#Simple properties [email protected] mail.port=9000 [email protected]
Spring的属性名字匹配支持很多格式，如下所示所有的格式都可以和hostName进行匹配：
mail.hostName mail.hostname mail.host_name mail.host-name mail.HOST_NAME
如果你不想使用@Configuration， 那么需要在@EnableConfigurationProperties注解中手动导入配置文件如下：
@SpringBootApplication @EnableConfigurationProperties(ConfigProperties.class) public class ConfigPropApp { public static void main(String[] args) { SpringApplication.run(ConfigPropApp.class,args); } }
我们也可以在@ConfigurationPropertiesScan中指定Config文件的路径:
@SpringBootApplication @ConfigurationPropertiesScan("com.flydean.config") public class ConfigPropApp { public static void main(String[] args) { SpringApplication.run(ConfigPropApp.class,args); } }
这样的话程序只会在com.flydean.config包中查找config文件。
属性嵌套
我们可以嵌套class，list，map， 下面我们举个例子，先创建一个普通的POJO：
@Data public class Credentials { private String authMethod; private String username; private String password; }
然后创建一个嵌套的配置文件：
@Data @Configuration @ConfigurationProperties(prefix = "nestmail") public class NestConfigProperties { private String host; private int port; private String from; private List defaultRecipients; private Map additionalHeaders; private Credentials credentials; }
对应的属性文件如下：
# nest Simple properties [email protected] nestmail.port=9000 [email protected] #List properties nestmail.defaultRecipients[0][email protected] nestmail.defaultRecipients[1][email protected] #Map Properties nestmail.additionalHeaders.redelivery=true nestmail.additionalHeaders.secure=true #Object properties nestmail.credentials.username=john nestmail.credentials.password=password nestmail.credentials.authMethod=SHA1
@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; }
对应的属性文件：
conversion.employee=john,2000
我们需要自己实现一个Converter接口的转换类：
@Component @ConfigurationPropertiesBinding public class EmployeeConverter implements Converter { @Override public Employee convert(String from) { String[] data = from.split(","); return new Employee(data[0], Double.parseDouble(data[1])); } }
本文的例子可以参看: https://github.com/ddean2009/learn-springboot2/tree/master/springboot-ConfigurationProperties
以上就是SpringBoot @ConfigurationProperties使用详解的详细内容，更多请关注gaodaima搞代码网其它相关文章！
转载请注明原文链接：SpringBoot @ConfigurationProperties使用详解
