文章目录

• 简介
• @SpringBootApplication
• @EnableAutoConfiguration
• 条件自动配置
• @ConditionalOnClass 和 @ConditionalOnMissingClass
• @ConditionalOnProperty
• @ConditionalOnResource
• @ConditionalOnWebApplication 和 @ConditionalOnNotWebApplication
• @ConditionalExpression
• @Conditional

Spring Boot注解

简介

Spring Boot通过自动配置让我们更加简单的使用Spring。在本文中我们将会介绍org.springframework.boot.autoconfigure 和org.springframework.boot.autoconfigure.condition 里面经常会用到的一些注解。

@SpringBootApplication

首先我们看一下@SpringBootApplication：

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

@SpringBootApplication被用在Spring Boot应用程序的Main class中，表示整个应用程序是Spring Boot。

@SpringBootApplication实际上是@Configuration, @EnableAutoConfiguration 和 @ComponentScan 的集合。

@EnableAutoConfiguration

@EnableAutoConfiguration 意味着开启了自动配置。这意味着Spring Boot会去在classpath中查找自动配置的beans，并且自动应用他们。

注意， @EnableAutoConfiguration需要和@Configuration配合使用。

@Configuration
@EnableAutoConfiguration
public class VehicleFactoryConfig {
}

条件自动配置

有时候，我们在自定义自动配置的时候，希望根据某些条件来开启自动配置，Spring Boot 提供了一些有用的注解。

这些注解可以和@Configuration 类 或者 @Bean 方法一起使用。

@ConditionalOnClass 和 @ConditionalOnMissingClass

这两个注解的意思是，如果注解参数中的类存在或者不存在则Spring会去实例化自动配置的bean。

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

@ConditionalOnBean 和 @ConditionalOnMissingBean

这两个和上面的区别在于，这两个是判断是否有实例化的bean存在。

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

@ConditionalOnProperty

使用这个注解我们可以判断Property的某些属性是不是需要的值：

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

@ConditionalOnResource

只有当某些resource存在的时候，才会起作用。

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

@ConditionalOnWebApplication 和 @ConditionalOnNotWebApplication

这两个注解通过判断是否web应用程序。

@Bean
    @ConditionalOnWebApplication
    HealthCheckController healthCheckController() {
        // ...
        return null;
    }

@ConditionalExpression

这个注解可以使用SpEL构造更加复杂的表达式：

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

@Conditional

还有一种更加复杂的应用叫@Conditional，它的参数是一个自定义的condition类。

@Bean
    @Conditional(HibernateCondition.class)
    Properties newAdditionalProperties() {
        //...
        return null;
    }

public class HibernateCondition implements Condition {
    @Override
    public boolean matches(ConditionContext conditionContext, AnnotatedTypeMetadata annotatedTypeMetadata) {
        return false;
    }
}

这个类需要实现matches方法。

本文的例子可以参考：https://github.com/ddean2009/learn-springboot2/tree/master/spring-boot-annotations

更多教程请参考 flydean的博客