在 Spring4 中推出了注解,方便程序根据当前环境或者容器情况来动态注入 bean。在 SpringBoot,SpringCloud 中基于注解扩展了很多更实用的条件注解。本章节将介绍 @ConditionalOnBean 条件注解的作用和用法。
@ConditionalOnBean 注解用来指定多个 bean,只有当指定的所有 bean 均已经包含在 BeanFactory 中时才匹配 @Conditional 注解。但是同一 bean 不必满足这些要求。
当 @ConditionalOnBean 注解放置在 @Bean 方法上时,bean 类默认为工厂方法的返回类型,例如:
@Configuration
public class MyAutoConfiguration {
@ConditionalOnBean
@Bean
public MyService myService() {
...
}
}在上面的示例中,如果 BeanFactory 中已经包含 MyService 类型的 Bean,则条件将匹配。
该条件只能匹配到目前为止应用程序上下文已处理的 bean 定义。因此,强烈建议仅在自动配置类上使用此条件。如果候选 bean 可能是由另一种自动配置创建的,请确保使用此条件的 bean 在之后运行。源码如下:
@Target({ ElementType.TYPE, ElementType.METHOD })
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnBeanCondition.class)
public @interface ConditionalOnBean {
/**
* 当在 BeanFactory 中包含指定的 bean 时,该条件匹配。
*/
Class<?>[] value() default {};
/**
* 应该检查的bean的类类型名称。当BeanFactory中包含指定的所有类的bean时,条件匹配。
*/
String[] type() default {};
/**
* 当在 BeanFactory 中的 bean 上定义了所有指定的注释时,该条件匹配。
*/
Class<? extends Annotation>[] annotation() default {};
/**
* 要检查的bean的名称。当所有指定的Bean名称都包含在BeanFactory中时,条件匹配。
*/
String[] name() default {};
/**
* 决定是否应考虑应用程序上下文层次结构(父上下文)的策略。
*/
SearchStrategy search() default SearchStrategy.ALL;
/**
* 可能在其通用参数内包含指定 Bean 类型的其他类。例如,声明 value = Name.class 和
* parameterizedContainer = NameRegistration.class 的注解,将同时检测 Name 和 NameRegistration<Name>。
*/
Class<?>[] parameterizedContainer() default {};
}我们创建用户和订单服务,然后分别通过两个 @Configuration 来自动配置服务,服务将根据 @ConditionalOnBean 条件动态创建。
(1)创建两个服务
a、UserService.java 服务
public class UserService {
}b、OrderService.java 服务
public class OrderService {
}(2)创建两个 @Configuration 类,并在类中通过 @ConditionalOnBean 进行条件自动配置。
a、UserConfig.java 配置
@Configuration
@ConditionalOnBean(InitUser.class)
public class UserConfig {
@Bean
public UserService userService() {
System.out.println("UserService -> userService()");
return new UserService();
}
}b、OrderConfig.java 配置
@Configuration
@ConditionalOnBean(InitOrder.class)
public class OrderConfig {
@Bean
public OrderService orderService() {
System.out.println("OrderConfig -> orderService()");
return new OrderService();
}
}(3)上面用户和订单配置中,通过 @ConditionalOnBean 注解要求用户服务必须要在 BeanFactory 中包含 InitUser Bean;要求订单服务必须要在 BeanFactory 中包含 InitOrder Bean。如下图:
// 初始化用户服务
@Component
public class InitUser {
}
// 初始化订单服务
public class InitOrder {
}上图中,InitUser 使用了 @Component 注解将它注入到 BeanFactory 中;而 InitOrder 并没有使用任何注解,没有被注入到 BeanFactory 中,因此就导致 @ConditionalOnBean(InitOrder.class) 匹配失败,不去自动配置 orderService()。
(4)客户端,在客户端通过 ApplicationContext 类动态获取注入的服务。如下:
import com.huangx.springboot.springboot_autoconfig_demo2.service.OrderService;
import com.huangx.springboot.springboot_autoconfig_demo2.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationContext;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@SpringBootApplication
public class SpringbootAutoconfigDemo2Application {
@Autowired
private ApplicationContext applicationContext;
public static void main(String[] args) {
SpringApplication.run(SpringbootAutoconfigDemo2Application.class, args);
}
@GetMapping("/")
public String index() {
UserService userService = null;
try {
userService = applicationContext.getBean(UserService.class);
} catch (Exception e) {
System.err.println(e.getMessage());
}
OrderService orderService = null;
try {
orderService = applicationContext.getBean(OrderService.class);
} catch (Exception e) {
System.err.println(e.getMessage());
}
return "userService=" + userService + "<br/>" +
"orderService=" + orderService;
}
}运行上面程序后,我们访问 http://localhost:8080 地址,输出如下图:

上图中,我们只获取到了用户服务,没有获取到订单服务对象。