SpringBoot 定义了许多条件化注解,可以将它们用到配置类上,以说明生效条件。
条件化注解 | 生效条件 |
---|---|
@ConditionalOnBean | 配置了特定的 Bean。 |
@ConditionalOnMissingBean | 没有配置特定的 Bean。 |
@ConditionalOnClass | Classpath 里有指定的类。 |
@ConditionalOnMissingClass | Classpath 里没有指定的类。 |
@ConditionalOnExpression | 给定的 SpringExpressionLanguage(SpEL) 表达式计算结果为 true。 |
@ConditionalOnJava | Java 的版本匹配特定值或者一个范围值。 |
@ConditionalOnJndi | JNDI 参数必须存在。 |
@ConditionalOnProperty | 指定的属性有一个明确的值。 |
@ConditionalOnResource | Classpath 里存在指定的资源。 |
@ConditionalOnWebApplication | 是一个 Web 应用程序。 |
@ConditionalOnNotWebApplication | 不是一个 Web 应用程序。 |
比如 SpringBootWebSecurityConfiguration.java 的源码为:
@Configuration
@ConditionalOnClass(WebSecurityConfigurerAdapter.class)
@ConditionalOnMissingBean(WebSecurityConfigurerAdapter.class)
@ConditionalOnWebApplication(type = Type.SERVLET)
public class SpringBootWebSecurityConfiguration {
@Configuration
@Order(SecurityProperties.BASIC_AUTH_ORDER)
static class DefaultConfigurerAdapter extends WebSecurityConfigurerAdapter {
}
}
SpringBootWebSecurityConfiguration 配置了三个条件化注解,也就是说 SpringBootWebSecurityConfiguration 必须在这些条件都满足的情况下,才能生效:
- Classpath 里有 WebSecurityConfigurerAdapter.class。
- 没有配置 WebSecurityConfigurerAdapter Bean。
- 是一个 Web 应用程序。
其中 ConditionalOnWebApplication 注解存在这些类型:
参数 | 说明 |
---|---|
SERVLET | 基于 servlet 的 web 应用程序。 |
REACTIVE | 基于 reactive 的 web 应用程序。 |
ANY | 上述两种都可以。 |
基于 reactive 的 web 应用程序是 Spring 5 新增的模块,名为 spring-webflux。 它可以用少量线程来处理 request 和 response io 操作,这些线程统称为 Loop 线程。那些业务中阻塞操作,会提交给响应式框架的 work 线程进行处理,而那些不阻塞的操作则在 Loop 线程中进行处理。通过这种方式,可以大大提高 Loop 线程的利用率。