Spring Boot 从入门到实践系列教程（3）- Spring注解

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
@EnableAutoConfiguration
class VehicleFactoryConfig {}

通常，当我们编写自定义自动配置时，我们希望Spring 有条件地使用它们。我们可以通过本节中的注释来实现这一点。

4.自动配置条件

我们可以在本节中将注释放在@Configuration类或@Bean方法上。

在接下来的部分中，我们将仅介绍每种情况背后的基本概念。有关详细信息，请访问此文章。

4.1 @ConditionalOnClass和@ConditionalOnMissingClass

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

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

4.2 @ConditionalOnBean和@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

@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() {
    //...
}

5 结论

在本文中，我们概述了如何微调自动配置过程并为自定义自动配置bean提供条件。