springboot使用@ConfigurationProperties自动绑定配置参数属性
@ConfigurationProperties使用
@ConfigurationProperties是 springboot提供用于将配置文件中的属性值映射到 Java bean对象上。通过使用该注解，我们可以方便地将属性文件中的值绑定到一个实例化的类对象上，从而方便地在应用程序中使用这些属性。
@ConfigurationProperties注解有一个参数prefix用来指定属性公共前缀
@Configuration
@ConfigurationProperties(prefix = "myconfig")
@Data
public class MyConfigProperty {
private int port;
//找不到的属性不会注入
private String hhh;
}
一般作为属性注入对象，首先定义成一个@Configuration。然后使用@ConfigurationProperties指定关联属性的前缀。这样如果配置文件中有myconfig.port的值就会自动绑定到MyConfigProperty类的port属性上。前提要有对应的set方法。
除了在类上标注外，还可以在@Bean方法上
@Configuration
public class MyConfigByMethod {
@Bean
@ConfigurationProperties(prefix = "myconfig")
public MyConfig myConfig(){
return new MyConfig();
}
}
观察spring的源码，还会使用@EnableConfigurationProperties引入被@ConfigurationProperties修饰的bean
框架自动装配解析
在springboot框架自动装配中有一个内置的用来处理@ConfigurationProperties注解的配置类ConfigurationPropertiesAutoConfiguration，该配置类引入@EnableConfigurationProperties,然后间接引入EnableConfigurationPropertiesRegistrar，EnableConfigurationPropertiesRegistrar在configuration初始化的时候会调用其registerBeanDefinitions()方法进行配置类中扩展beanDef的加载。
EnableConfigurationPropertiesRegistrar#registerBeanDefinitions
public void registerBeanDefinitions(AnnotationMetadata metadata, BeanDefinitionRegistry registry) {
registerInfrastructureBeans(registry);
registerMethodValidationExcludeFilter(registry);
ConfigurationPropertiesBeanRegistrar beanRegistrar = new ConfigurationPropertiesBeanRegistrar(registry);
getTypes(metadata).forEach(beanRegistrar::register);
}
private Set<Class<?>> getTypes(AnnotationMetadata metadata) {
return metadata.getAnnotations().stream(EnableConfigurationProperties.class)
.flatMap((annotation) -> Arrays.stream(annotation.getClassArray(MergedAnnotation.VALUE)))
.filter((type) -> void.class != type).collect(Collectors.toSet());
}
static void registerInfrastructureBeans(BeanDefinitionRegistry registry) {
ConfigurationPropertiesBindingPostProcessor.register(registry);
BoundConfigurationProperties.register(registry);
}
这里主要会完成两件事件：
1、registerInfrastructureBeans会将ConfigurationPropertiesBindingPostProcessor注册到容器中，这是一个后置处理其，属性的赋值会在其后置方法里完成。
2、注册合适的ConfigurationProperties类型bean， 当前metadata是正在初始化的Configuration类，然后从其注解上获取带有EnableConfigurationProperties注解作为bean定义加载到容器中。
来看几个自动装配的例子：
ServletWebServerFactoryAutoConfiguration
ServletWebServerFactoryAutoConfiguration上带有@EnableConfigurationProperties(ServerProperties.class)注解，则ServerProperties会作为一个bean进行处理。ServerProperties上配置有@ConfigurationProperties(prefix = “server”, ignoreUnknownFields = true)，我们场景的server.port属性就会注入到ServerProperties.port属性上。
DataSourceAutoConfiguration
@EnableConfigurationProperties(DataSourceProperties.class)
public class DataSourceAutoConfiguration {}
@ConfigurationProperties(prefix = "spring.datasource")
public class DataSourceProperties{}
DataSourceProperties会被做为一个bean加载，"spring.datasource"下的属性会注入到DataSourceProperties属性中。
ConfigurationPropertiesBindingPostProcessor
ConfigurationPropertiesBindingPostProcessor是一个bean后置处理器，在bean实例化后会调用其后置方法
public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
bind(ConfigurationPropertiesBean.get(this.applicationContext, bean, beanName));
return bean;
}
ConfigurationPropertiesBean.get()方法会判断当前bean是否有ConfigurationProperties注解，如果有会进行对应的属性绑定。最后使用org.springframework.boot.context.properties.bind.Binder类进行属性绑定。这里ConfigurationProperties会有两部分，一是框架通过autoConfig自动装配的，一种是我们自己显示使用@ConfigurationProperties修饰的bean。这里看到我们在自定义@ConfigurationProperties时候不一定非用@Configuration进行修饰，只要当前类能被解析成一个bean，都会调用该后置方法进行对应配置属性的赋值。
属性元数据信息
可配置的属性在每个jar包META-INFO/spring-configuration-metadata.json文件。这样一般在IDEA配置application文件时候都能根据该文件里的元数据信息进行提示配置。
例如server.port配置在spring-boot-autoconfigure.jar包中
{
"name": "server.port",
"type": "java.lang.Integer",
"description": "Server HTTP port.",
"sourceType": "org.springframework.boot.autoconfigure.web.ServerProperties",
"defaultValue": 8080
},