环境:Springboot2.4.12
准备环境
@Componentn@ConfigurationProperties("pack")npublic class PackProperties {nn private boolean enabled;nn private InetAddress remoteAddress;nn private final Security security = new Security();nn public boolean isEnabled() {n return enabled;n }nn public void setEnabled(boolean enabled) {n this.enabled = enabled;n }nn public InetAddress getRemoteAddress() {n return remoteAddress;n }nn public void setRemoteAddress(InetAddress remoteAddress) {n this.remoteAddress = remoteAddress;n }nn public Security getSecurity() {n return security;n }nn public static class Security {nn private String username;nn private String password;nn private List<String> roles = new ArrayList<>(Collections.singleton("USER"));nn public String getUsername() {n return username;n }nn public void setUsername(String username) {n this.username = username;n }nn public String getPassword() {n return password;n }nn public void setPassword(String password) {n this.password = password;n }nn public List<String> getRoles() {n return roles;n }nn public void setRoles(List<String> roles) {n this.roles = roles;n }nn @Overriden public String toString() {n return "Security [username=" + username + ", password=" + password + ", roles=" + roles + ", " + roles.size()n + "]";n }nn }nn @Overriden public String toString() {n return "PackProperties [enabled=" + enabled + ", remoteAddress=" + remoteAddress + ", security=" + security + "]";n }nn}
JavaBean属性绑定
绑定一个声明标准JavaBean属性的bean。
pack:n remote-address: 192.168.2.100n security:n roles: GUEST, ADMIN #List集合可用通过逗号`,`分割方式配置
输出:
PackProperties [enabled=false, remoteAddress=/192.168.2.100, security=Security [username=null, password=null, roles=[GUEST, ADMIN], 2]]
根据上面的JavaBean定义属性说明:
- pack.enabled, 默认是为false.
- pack.remote-address, 自动从String转换为InetAddress
- pack.security.username, 使用嵌套的“security”对象,该对象的名称由属性的名称确定。特别是,这里根本没有使用返回类型,可以使用SecurityProperties。
- pack.security.roles, 使用默认为USER的String集合。
构造器绑定
修改上面的PackProperties
@Componentn@ConstructorBindingn@ConfigurationProperties("pack")npublic class PackProperties {nn private boolean enabled;nn private InetAddress remoteAddress;nn private final Security security;nn public PackProperties(boolean enabled, InetAddress remoteAddress, Security security) {n this.enabled = enabled;n this.remoteAddress = remoteAddress;n this.security = security;n }n}
在此设置中,@ConstructorBinding注释用于指示应使用构造函数绑定。这意味着绑定器将期望找到一个包含您希望绑定的参数的构造函数。
@ConstructorBinding类的嵌套成员(如上例中的Security)也将通过其构造函数进行绑定。
可以使用@DefaultValue指定默认值,并且应用相同的转换服务将String值强制转换为缺失属性的目标类型。默认情况下,如果没有属性绑定到Security, PackProperties实例将包含用于security 的 null值。如果你希望返回一个非空的Security实例,即使没有属性绑定到它,你可以使用一个空的@DefaultValue注释来这样做:
如果只是上面那样配置,程序会报错,因为上面的PackProperties也是个Bean,并且只提供了一个有参数的构造函数,那么容器就会进行构造方法注入,从容器中查找参数类型的Bean进行注入,而容器当前是没有这些bean的,也就是说容器会吧构造函数中的参数以Bean的形式进行注入,并不会(也不知道)从配置文件中读取相关的值进行设置。通过如下方式可以实现构造函数的配置。
- @ConfigurationPropertiesScan
修改属性配置类
@ConstructorBindingn@ConfigurationProperties("pack")npublic class PackProperties {n}
在启动类上添加注解
@SpringBootApplicationn@ConfigurationPropertiesScan(basePackages = {"com.pack"})npublic class SpringWebDemoApplication {n}
该种方式就可以实现构造函数的注入。
- @EnableConfigurationProperties
该种方式也是在一个配置类或者启动类上添加注解
@SpringBootApplicationn@EnableConfigurationProperties(PackProperties.class)npublic class SpringWebDemoApplication {n}
Enabling @ConfigurationProperties-annotated types
Spring Boot提供了基础设施来绑定@ConfigurationProperties类型并将它们注册为bean。可以逐个类地启用配置属性,也可以启用与组件扫描方式类似的配置属性扫描。
有时,带有@ConfigurationProperties注释的类可能不适合扫描,例如,如果你正在开发自己的自动配置,或者希望有条件地启用它们。在这些情况下,使用 @EnableConfigurationProperties注释指定要处理的类型列表。这可以在任何 @Configuration类上完成,如下所示:
@Configurationn@EnableConfigurationProperties(PackProperties.class)npublic class PropConfig {n}
要使用配置属性扫描,请将@ConfigurationPropertiesScan注释添加到应用程序中。通常,它被添加到用@SpringBootApplication注释的主应用程序类中,但它也可以添加到任何@Configuration类中。默认情况下,扫描将从声明注释的类的包中进行。如果你想定义特定的包来扫描,你可以这样做,如下所示的例子:
@SpringBootApplicationn@ConfigurationPropertiesScan({ "com.pack.app", "org.pack.another" })npublic class MyApplication {n}
第三方配置
除了使用@ConfigurationProperties来注释类之外,还可以在公共的@Bean方法上使用它。当你希望将属性绑定到你无法控制的第三方组件时,这样做特别有用。
@ConfigurationProperties(prefix = "pack.third")n@Beannpublic ThirdComponent thirdComponent() {n return new ThirdComponent();n}
在配置中配置的以pack.third为前缀的所有配置都将为JavaBean属性都被映射到ThirdComponent bean上。
@ConfigurationProperties验证
Spring Boot尝试验证@ConfigurationProperties类,只要它们被Spring的@Validated注解注解。您可以使用JSR-303 javax.validation约束注释直接在配置类上。要做到这一点,请确保类路径上有一个符合JSR-303的实现,然后向字段添加约束注释,如下所示:
@ConstructorBindingn@ConfigurationProperties("pack")n@Validatednpublic class PackProperties {n private boolean enabled;n @NotNull(message = "请输入远程地址")n private InetAddress remoteAddress;n}
注意:还需要确保环境中有JSR-303的实现,这里使用的Hidernate
<dependency>n <groupId>org.hibernate</groupId>n <artifactId>hibernate-validator</artifactId>n <version>6.0.7.Final</version>n</dependency>
如果没有配置remoteAddress,程序启动将会报错误
Binding to target org.springframework.boot.context.properties.bind.BindException: Failed to bind properties under 'pack' to com.pack.propsbinding.PackProperties failed:nn Property: pack.remoteAddressn Value: nulln Reason: 请输入远程地址
为了确保总是为嵌套属性触发验证,即使没有找到属性,关联字段必须用@Valid注释。下面的示例构建在前面的PackProperties示例之上:
@Componentn@ConfigurationProperties("pack")n@Validatednpublic class PackProperties2 {n private boolean enabled;n @NotNull(message = "请输入远程地址")n private InetAddress remoteAddress;n @Validn private Security security = new Security() ;n}
进过测试结果验证与官方文档不一致?嵌套属性即便不加@Valid注解也是可以在嵌套对象中的属性添加验证一样会生效。
@ConfigurationProperties vs. @Value
@Value注释是一个核心容器特性,它不提供与类型安全的配置属性相同的特性。下表总结了@ConfigurationProperties和@Value支持的特性:
Feature
@ConfigurationProperties
@Value
宽松绑定
Yes
Limited (see note below)
元数据支持
Yes
No
SpEL表达式
No
Yes
完毕!!!
spring data jpa 高级应用
Spring中的@Configuration注解你真的了解吗?
Spring中字段格式化的使用详解
Spring容器这些扩展点你都清楚了吗?
Spring MVC 异常处理方式
SpringBoot WebFlux整合Spring Security进行权限认证
Spring是如何解决循环依赖的?
Spring事务实现原理源码分析
Spring MVC 异步请求方式