在Spring Boot中使用 @ConfigurationProperties 注解

但 Spring Boot 提供了另外一种方式 ，可以根据类型校验和管理application中的bean。 这里会介绍如何使用@ConfigurationProperties。
继续使用mail作例子。配置放在mail.properties文件中。属性必须命名规范才能绑定成功。举例:
1 protocol and PROTOCOL will be bind to protocol field of a bean
2 smtp-auth , smtp_auth , smtpAuth will be bind to smtpAuth field of a bean
3 smtp.auth will be bind to … hmm to smtp.auth field of a bean!

Spring Boot 使用一些松的规则来绑定属性到@ConfigurationProperties bean 而且支持分层结构（hierarchical structure）。
开始建立一个@ConfigurationProperties bean:

@ConfigurationProperties(locations = "classpath:mail.properties", ignoreUnknownFields = false, prefix = "mail") public class MailProperties { public static class Smtp { private boolean auth; private boolean starttlsEnable; // ... getters and setters } @NotBlank private String host; private int port; private String from; private String username; private String password; @NotNull private Smtp smtp; // ... getters and setters }

…从以下属性中建立 ( mail.properties ):

mail.host=localhost mail.port=25 mail.smtp.auth=false mail.smtp.starttls-enable=false mail.from=me@localhost mail.username= mail.password=

上例中咱们用@ConfigurationProperties注解就能够绑定属性了。ignoreUnknownFields = false告诉Spring Boot在有属性不能匹配到声明的域的时候抛出异常。开发的时候很方便! prefix 用来选择哪一个属性的prefix名字来绑定。
请注意setters 和 getters 须要在@ConfigurationProperties bean中建立! 与@Value注解相反， 这带来了代码中的一些困扰 (特别是简单的业务中，我的观点).
OK，可是咱们须要用属性来配置 application. 有至少两种方式来建立@ConfigurationProperties。便可以搭配@Configuration 注解来提供 @Beans 也能够单独使用并注入 @Configuration bean。

方案1:

@Configuration @ConfigurationProperties(locations = "classpath:mail.properties", prefix = "mail") public class MailConfiguration { public static class Smtp { private boolean auth; private boolean starttlsEnable; // ... getters and setters } @NotBlank private String host; private int port; private String from; private String username; private String password; @NotNull private Smtp smtp; // ... getters and setters @Bean public JavaMailSender javaMailSender() { // omitted for readability } }

方案2

咱们和上面例子同样注解属性，而后用 Spring的@Autowire来注入 mail configuration bean:

@Configuration @EnableConfigurationProperties(MailProperties.class) public class MailConfiguration { @Autowired private MailProperties mailProperties; @Bean public JavaMailSender javaMailSender() { // omitted for readability } }

请注意@EnableConfigurationProperties注解。 这个注解告诉Spring Boot 使能支持@ConfigurationProperties。若是不指定会看到以下异常:

org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type [demo.mail.MailProperties] found for dependency: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

注意: 还有其余办法 (Spring Boot 老是有其余办法!) 让@ConfigurationProperties beans 被添加 – 用@Configuration或者 @Component注解, 这样就能够在 component scan时候被发现了。

总结：

@ConfigurationProperties很方便使用。 比用@Value注解好吗? 在特定的方案中是的,这只是一个选择问题。

做者：crocodile_b 连接：http://www.jianshu.com/p/df57fefe0ab7 來源：简书 著做权归做者全部。商业转载请联系做者得到受权，非商业转载请注明出处。