1、基本简介

• @ConfigurationProperties注解用于自动配置绑定，可以将application.properties配置中的值注入到bean对象上。

• 该注解使用必须将对象注入到IOC容器中才有配置绑定的功能。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Indexed
public @interface ConfigurationProperties {
	//1. 匹配的前缀
    @AliasFor("prefix")
    String value() default "";

	//2. 同上
    @AliasFor("value")
    String prefix() default "";

	//3. 忽略属性类型不匹配的字段
    boolean ignoreInvalidFields() default false;

	//4. 忽略类中未知的属性
    boolean ignoreUnknownFields() default true;
}

该注解可以使用在类上、方法上；会自动进行配置导入。

2、基本使用

1. 先在application.properties中配置所需的参数

2. 编写一个Car类、DeepSkyBlue类分别使用@ConfigurationProperties在类上配置和方法上配置。

3. 测试@ConfigurationProperties各属性如何使用。

application.properties中配置如下

mycar.price=200w
mycar.brand=paramera

color.alpha=15

2.1 两种基本使用

标注在组件类上使用，一定要有组件注解！

@Data                       //get/set方法
@AllArgsConstructor         //全参构造
@NoArgsConstructor          //无参构造
@Component("car")           //组件注册, 必须有组件注册手段
@ConfigurationProperties(prefix = "mycar")
public class Car {
    private String brand;			//品牌
}

标注在方法上使用

@Configuration
public class MyConfig {

    @Bean("deepSkyBlue")
    @ConfigurationProperties(prefix = "color")
    public DeepSkyBlue deepSkyBlue(){
        return new DeepSkyBlue();
    }
}

2.2 字段不匹配

• ignoreInvalidFields默认情况为true会自动忽略值类型不匹配的字段

• 当ignoreInvalidFields=false手动关闭时如果值类型不匹配将会爆出异常。

@Data                       //get/set方法
@AllArgsConstructor         //全参构造
@NoArgsConstructor          //无参构造
@Component("car")           //组件注册, 必须有组件注册手段
@ConfigurationProperties(prefix = "mycar", ignoreInvalidFields = false)
public class Car {

    private int price;
    private String brand;
}

2.3 未知属性字段

• 默认情况下ignoreUnknownFields属性是true，会忽略掉对象中未知的字段。

• 手动关闭ignoreUnknownFields=false后当出现未知字段时会出现异常。

@Data                       //get/set方法
@AllArgsConstructor         //全参构造
@NoArgsConstructor          //无参构造
@Component("car")           //组件注册, 必须有组件注册手段
@ConfigurationProperties(prefix = "mycar", ignoreUnknownFields = true)
public class Car {

    private String price;			//修改为String类型
    private String brand;
    private String origin;			//忽略
}

3、@EnableConfigurationProperties注解

可以看到上面的配置绑定需要使用@Component组件注解进行注册才能进行绑定，如果是写好的第三方包呢？那么没有办法给第三方包加入的时候可以使用使用方法标记进行配置绑定或者@EnableConfigurationProperties注解进行自动注册

@Data                       //get/set方法
@AllArgsConstructor         //全参构造
@NoArgsConstructor          //无参构造
@ConfigurationProperties(prefix = "mycar")
public class Car {

    private String price;
    private String brand;

}

@Configuration
@EnableConfigurationProperties(value = {Car.class})		//自动配置绑定
public class MyConfig {

	@Bean("deepSkyBlue")
    @ConfigurationProperties(prefix = "color")
    public DeepSkyBlue deepSkyBlue(){
        return new DeepSkyBlue();
    }

}

4、补充

• 根据目前所测试的只有绑定的属性字段与配置中所配置的属性名称一致（忽略大小写）才会进行自动的配置绑定

• 字段名不匹配就不会进行自动配置

@Data                       //get/set方法
@AllArgsConstructor         //全参构造
@NoArgsConstructor          //无参构造
@Component("car")           //组件注册, 必须有组件注册手段
@ConfigurationProperties(prefix = "mycar")
public class Car {
    private String Price;
    private String pRice;
    private String CarPrice;
    private String Price_Car;
    private String Car_Price;

}