Spring Boot 注解大全（实时更新中）

@PropertySource 用于从某些地方加载 *.properties 文件内容，并将其中的属性加载到 IoC 容器中，便于填充一些 bean 定义属性的占位符（placeholder），当然，这需要 PropertySourcesPlaceholderConfigurer 的配合。

如果我们使用 Java 8 或者更高版本开发，那么，我们可以并行声明多个 @PropertySource：

@Configuration@PropertySource(“classpath:1.properties”)@PropertySource(“classpath:2.properties”)@PropertySource(“…”)public class XConfiguration{ …}

如果我们使用低于 Java 8 版本的 Java 开发 Spring 应用，又想声明多个 @PropertySource，则需要借助 @PropertySources 的帮助了，代码如下所示：

@PropertySources({ @PropertySource(“classpath:1.properties”), @PropertySource(“classpath:2.properties”), …})public class XConfiguration{ …}

[](()@Import 与 @ImportResource

---

在 XML 形式的配置中，我们通过 的形式将多个分开的容器配置合到一个配置中，在 JavaConfig 形式的配置中，我们则使用 @Import 这个 Annotation 完成同样目的：

@Configuration@Import(MockConfiguration.class)public class XConfiguration { …}

@Import 只负责引入 JavaConfig 形式定义的 IoC 容器配置，如果有一些遗留的配置或者遗留系统需要以 XML 形式来配置（比如 dubbo 框架），我们依然可以通过 @ImportResource 将它们一起合并到当前 JavaConfig 配置的容器中。

[](()@ConditionalOnXXX 基于条件的自动配置

---

基于条件的自动配置来源于 Spring 框架中“基于条件的配置”这一特性。在 Spring 框架中，我们可以使用 @Conditional 这个 Annotation 配合 @Configuration 或者 @Bean 等 Annotation 来干预一个配置或者 bean 定义是否能够生效，其最终实现的效果或者语义类似于如下伪代码：

if(符合 @Conditional 规定的条件){

加载当前配置(enable current Configuration)或者注册当前bean定义；

}

要实现基于条件的配置，我们只要通过 @Conditional 指定自己的 Condition 实现类就可以了（可以应用于类型 Type 的标注或者方法 Method 的标注）：

@Conditional({MyCondition1.class, MyCondition2.class, …})

最主要的是，@Conditional 可以作为一个 Meta Annotation 用来标注其他 Annotation 实现类，从而构建各色的复合 Annotation，比如 Spr 《一线大厂Java面试题解析+后端开发学习笔记+最新架构讲解视频+实战项目源码讲义》无偿开源 威信搜索公众号【编程进阶路】 ingBoot的 autoconfigure 模块就基于这一优良的革命传统，实现了一批 Annotation（位于 org.springframework.boot.autoconfigure.condition 包下），条件注解如下：

• @ConditionalOnBean：当容器里有指定的 Bean 的条件下。

• @ConditionalOnClass：当类路径下有指定的类的条件下。

• @ConditionalOnExpression：基于 SpEL 表达式作为判断条件。

• @ConditionalOnJava：基于 JVM 版本作为判断条件。

• @ConditionalOnJndi：在 JNDI 存在的条件下查找指定的位置。

• @ConditionalOnMissingBean：当容器里没有指定 Bean 的情况下。

• @ConditionalOnMissingClass：当类路径下没有指定的类的条件下。

• @ConditionalOnNotWebApplication：当前项目不是 Web 项目的条件下。

• @ConditionalOnProperty：指定的属性是否有指定的值。

• @ConditionalOnResource：类路径是否有指定的值。

• @ConditionalOnSingleCandidate：当指定 Bean 在容器中只有一个，或者虽然有多个但是指定首选的 Bean。

• @ConditionalOnWebApplication：当前项目是 Web 项目的条件下。

有了这些复合 Annotation 的配合，我们就可以结合 @EnableAuto-Configurationn 实现基于条件的自动配置了。