Spring Boot Annotations

1.概述

Spring Boot 通过其自动配置功能使配置 Spring 变得更加容易。
介绍来自org.springframework.boot.autoconfigure和org.springframework.boot.autoconfigure.condition包的注解。

2. @SpringBootApplication

我们使用此注释来标记 Spring Boot应用进程的主类：

@SpringBootApplication
class VehicleFactoryApplication {

    public static void main(String[] args) {
        SpringApplication.run(VehicleFactoryApplication.class, args);
    }
}

@SpringBootApplication包含了@Configuration、@EnableAutoConfiguration和@ComponentScan注释及其默认属性

3. @EnableAutoConfiguration

@EnableAutoConfiguration，顾名思义，启用自动配置。这意味着 Spring Boot 在其类路径中查找自动配置 bean 并自动应用它们。
请注意，我们必须将此注释与@Configuration一起使用,@Configuration是Spring的注解.
@Configuration注解的作用：声明一个类为配置类，用于取代bean.xml配置文件注册bean对象。

@Configuration
@EnableAutoConfiguration
class VehicleFactoryConfig {}

4. Auto-Configuration Conditions

通常，当我们编写自定义自动配置时，我们希望 Spring 有条件地使用它们。我们可以通过本节中的注释来实现这一点。
我们可以将本节中的注释放在@Configuration类或@Bean方法上。
在接下来的部分中，我们将只介绍每个条件背后的基本概念。

4.1. @ConditionalOnClass and @ConditionalOnMissingClass

使用这些条件，Spring 将仅在注释参数中的类存在/不存在时才使用标记的自动配置 bean：

@Configuration
@ConditionalOnClass(DataSource.class)
class MySQLAutoconfiguration {
    //...
}

4.2. @ConditionalOnBean and @ConditionalOnMissingBean

当我们想要根据特定 bean 的存在与否来定义条件时，我们可以使用这些注释：

@Bean
@ConditionalOnBean(name = "dataSource")
LocalContainerEntityManagerFactoryBean entityManagerFactory() {
    // ...
}

4.3. @ConditionalOnProperty

有了这个注解，我们可以对属性的值设置条件：

@Bean
@ConditionalOnProperty(
    name = "usemysql", 
    havingValue = "local"
)
DataSource dataSource() {
    // ...
}

4.4. @ConditionalOnResource

我们可以让 Spring 仅在存在特定资源时才使用定义：

@ConditionalOnResource(resources = "classpath:mysql.properties")
Properties additionalProperties() {
    // ...
}

4.5. @ConditionalOnWebApplication and @ConditionalOnNotWebApplication

使用这些注解，我们可以根据当前应用进程是否是 Web 应用进程来创建条件：

@ConditionalOnWebApplication
HealthCheckController healthCheckController() {
    // ...
}

4.6. @ConditionalExpression

我们可以在更复杂的情况下使用此注释。当 SpEL 表达式计算为 true 时，Spring 将使用标记的定义：

@Bean
@ConditionalOnExpression("${usemysql} && ${mysqlserver == 'local'}")
DataSource dataSource() {
    // ...
}

4.7. @Conditional

对于更复杂的条件，我们可以创建一个评估自定义条件的类。我们告诉 Spring 将此自定义条件用于@Conditional：

@Conditional(HibernateCondition.class)
Properties additionalProperties() {
    //...
}