SpringBoot @ConfigurationProperties详解
文章目录
- 简介
- 添加依赖关系
- 一个简单的例子
- 属性嵌套
- @ConfigurationProperties和@Bean
- 属性验证
- 属性转换
- 自定义Converter
SpringBoot @ConfigurationProperties详解
简介
本文将会详细讲解@ConfigurationProperties在Spring Boot中的使用。
添加依赖关系
首先我们需要添加Spring Boot依赖:
<parent><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-parent</artifactId><relativePath/> <!-- lookup parent from repository -->
</parent>
一个简单的例子
@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
mail.hostname=host@mail.com
mail.port=9000
mail.from=mailer@mail.com
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<String> defaultRecipients;private Map<String, String> additionalHeaders;private Credentials credentials;
}
对应的属性文件如下:
# nest Simple properties
nestmail.hostname=mailer@mail.com
nestmail.port=9000
nestmail.from=mailer@mail.com#List properties
nestmail.defaultRecipients[0]=admin@mail.com
nestmail.defaultRecipients[1]=owner@mail.com#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 {@NotEmptyprivate 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.portValue: 0Reason: 最小不能小于1025Property: mail.hostNameValue: nullReason: 不能为空Action:Update your application's configurationProcess 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<String, Employee> {@Overridepublic 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
更多精彩内容且看:
- 区块链从入门到放弃系列教程-涵盖密码学,超级账本,以太坊,Libra,比特币等持续更新
- Spring Boot 2.X系列教程:七天从无到有掌握Spring Boot-持续更新
- Spring 5.X系列教程:满足你对Spring5的一切想象-持续更新
- java程序员从小工到专家成神之路(2020版)-持续更新中,附详细文章教程
更多教程请参考 flydean的博客
SpringBoot @ConfigurationProperties详解相关推荐
- SpringBoot配置详解
SpringBoot配置详解 本文链接:http://blog.battcn.com/2018/04/22/springboot/v2-config-properties/ 上一篇介绍了SpringB ...
- SpringBoot开发详解(三)--SpringBoot配置文件YML注意事项
SpringBoot开发详解(三)--SpringBoot配置文件YML注意事项 原创 2017年04月16日 20:00:12 11289 YML读取注意事项 使用YML时遇到的坑: 最近在做项目 ...
- spring-boot注解详解(一)
spring-boot注解详解(一) @SpringBootApplication @SpringBootApplication = (默认属性)@Configuration + @EnableAut ...
- 【SpringBoot 】SpringBoot注解详解
[SpringBoot ]SpringBoot注解详解 一.注解(annotations)列表 @SpringBootApplication:包含了@ComponentScan.@Configura ...
- Springboot Condition 详解
Springboot Condition 详解 Condition 是spring boot 4.0增加的功能,它可以选择性的创建bean @Conditional 源码查看 //// Source ...
- SpringBoot非官方教程 | 第二篇:SpringBoot配置文件详解
springboot采纳了建立生产就绪Spring应用程序的观点. Spring Boot优先于配置的惯例,旨在让您尽快启动和运行.在一般情况下,我们不需要做太多的配置就能够让spring boot正 ...
- Mybatis-Plus+SpringBoot框架详解
一.SpringBoot 概述 1.SpringBoot 简介 SpringBoot 提供了一种快速使用 Spring 的方式,基于约定优于配置的思想,可以让开发人员不必在配置与逻辑业务之间进行思维的 ...
- SpringBoot事务详解
文章目录 一.简介 1.介绍 2.事务特点 3.事务实现方式 3.1 MySql事务实现方式 3.2 SpringBoot实现机制 二.@Transactional详解 1.@Transactiona ...
- SpringBoot入门详解源码分析
注:文章内容来自于黑马的虎哥,个人感觉写的挺好的,所以只是做了简单整理,我只是文章的搬运工! # 0.学习目标 - 了解SpringBoot的作用 - 掌握java配置的方式 - 了解SpringBo ...
最新文章
- “.中国”域名总量跌至25.9万个:9月份净减2,249个
- 一场面试,用20秒介绍自己顺便教训了领导
- 社会保险省内转移需要什么手续或过程?
- itextpdf添加表格元素_itext生成pdf文件-表格
- 数学建模-灰色系统理论与灰色关联分析
- 在线广告系统的架构变迁
- 文档计算机无法分页,word文档总是重新分页 word文档老是分页显示怎么解决
- 2015级计算机科学与技术2班班级博客大全
- Formula One 常用函数及属性
- 毕业一年经历两次大裁员......
- python交互方式是什么意思_python交互模式是什么
- EOS私链发币简要说明
- 几个贝叶斯估计的例题
- CSS空格和换行的处理
- 五年Java架构师深入剖析微服务架构设计理念与技术体系(值得一看!)
- java生成随机密码,包含大小写字母,数字,特殊字符等
- 第九章 动态规划-1278:【例9.22】复制书稿(book)
- 速度来!《软技能:代码之外的生存指南 (第2版)》送书4本
- html实训报告致谢,学术论文致谢词范文
- Hadoop介绍以及安装使用入门