Spring Boot中选择性加载Bean的几种方式

说明:用过Spring框架的都知道其自动装配的特性,本文介绍几种选择性加载Bean的方式。Spring自动装配参考以下两篇文章:

@ConditionalOnProperty

@ConditionalOnProperty,根据配置文件中指定的值决定是否加载,如下:

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.stereotype.Component;

/**
 * 根据配置文件中指定的值决定是否加载;
 */
@Component
@ConditionalOnProperty(name = "dev.name", havingValue = "hezy", matchIfMissing = true)
public class OnProperty {
}

参数,其中:

  • name/value:配置项名称;

  • havingValue:配置值;

  • matchIfMissing:表示不存在该配置项时,是否加载Bean,默认false,需要注意,这里说的是没有该配置项,而不是配置值对应不上;


如上面的代码,表示配置文件中存在dev.name配置项,且值为hezy时加载Bean,没有配置项的话加载;

application.yml,如下:

yml 复制代码
server:
  port: 7084

dev:
  name: "dev"

启动项目,不加载该Bean,因为配置项的值对不上

@ConditionalOnJava

@ConditionalOnJava,根据Java版本决定是否加载,如下:

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnJava;
import org.springframework.boot.system.JavaVersion;
import org.springframework.stereotype.Component;

/**
 * 根据Java版本决定是否加载
 */
@Component
@ConditionalOnJava(JavaVersion.SEVENTEEN)
public class OnJava {
}

注解的参数只有一个,即Java版本,如我IDEA中加载的JDK11,填JavaVersion.SEVENTEEN,Java17,不会加载该Bean。但是如果设置的是JavaVersion.EIGHT,则会加载Bean,也就说这里向下兼容了。

(Java11)

(代码设置的Java8)

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnJava;
import org.springframework.boot.system.JavaVersion;
import org.springframework.stereotype.Component;

/**
 * 根据Java版本决定是否加载
 */
@Component
@ConditionalOnJava(JavaVersion.EIGHT)
public class OnJava {
}

启动项目,加载了Bean

@ConditionalOnBean

@ConditionalOnBean,根据Spring容器中是否存在指定的Bean决定是否加载。有以下三种配置:

  • 指定类:@ConditionalOnBean(OnJava.class)

  • 指定Bean:@ConditionalOnBean(name = "onProperty")

  • 指定多个类:@ConditionalOnBean({OnProperty.class, OnJava.class})

如下,表示只有容器中存在OnJava.class的Bean时才加载

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnBean;
import org.springframework.stereotype.Component;

/**
 * 根据Spring容器中是否存在指定的Bean决定是否加载
 */
@Component
@ConditionalOnBean(OnJava.class)
public class OnBean {
}

因为容器中有OnJava,所以OnBean也加载了;

@ConditionalOnMissingBean

@ConditionalOnMissingBean,根据Spring容器中是否不存在指定的Bean决定是否加载,与@ConditionalOnBean相反。也有以下三种配置方式:

  • 指定类:@ConditionalOnMissingBean(OnJava.class)

  • 指定Bean:@ConditionalOnMissingBean(name = "onProperty")

  • 指定多个类:@ConditionalOnMissingBean({OnProperty.class, OnJava.class})

如下,表示容器中OnJava、OnClass都不存在时才加载。注意如果指定多个类,它们的条件是 And 的关系,@ConditionalOnBean 也一样。

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.stereotype.Component;

/**
 * 根据Spring容器中是否不存在指定的Bean决定是否加载
 */
@Component
@ConditionalOnMissingBean({OnJava.class, OnProperty.class})
public class OnMissingBean {
}

如下,容器中没有OnProperty,但是OnJava有,所以OnMissingBean也不加载,需要都不存在才加载

@ConditionalOnClass

@ConditionalOnClass,根据类是否存在指定的类来决定是否加载,有以下三种配置:

  • 指定类:@ConditionalOnClass(OnJava.class);

  • 指定类的全限定类名:@ConditionalOnClass(name = "com.hezy.bean.OnJava")

  • 指定多个类:@ConditionalOnClass({OnJava.class, OnClass.class})

需要和上面的指定OnBean区分开,指定Bean是需要类加载到容器里,即类上要打@Component、@Service、@Controller等这样的注解,而OnClass就不用,只要你存在这样的类文件即可。

如下,表示存在OnJava类加载

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.stereotype.Component;

/**
 * 根据类是否存在指定的类来决定是否加载
 */
@Component
@ConditionalOnClass(name = "com.hezy.bean.OnJava")
public class OnClass {
}

把OnJava类上的@Component注解去掉,启动项目

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnJava;
import org.springframework.boot.system.JavaVersion;

/**
 * 根据Java版本决定是否加载
 */
@ConditionalOnJava(JavaVersion.EIGHT)
public class OnJava {
}

可以看到,容器里没有OnJava的Bean,但是OnClass加载了

@ConditionalOnMissingClass

@ConditionalOnMissingClass,根据类路径中是否不存在指定的类来决定是否加载,与@ConditionalOnClass相反,配置方式有两种:

  • 指定类的全限定类名:@ConditionalOnMissingClass("com.hezy.bean.OnJava")

  • 指定多个类:@ConditionalOnMissingClass({"com.hezy.bean.OnJava1", "com.hezy.bean.OnJava2"})

为什么少了指定类,因为这里配置的是不存在的类,不存在的类,怎么写 类名.class (笑)

如下,表示不存在对应路径的OnJava1、OnJava2时才加载,配置多个类,是And的关系,即需要都不存在才加载;

java 复制代码
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingClass;
import org.springframework.stereotype.Component;

/**
 * 根据类路径中是否不存在指定的类来决定是否加载
 */
@Component
@ConditionalOnMissingClass({"com.hezy.bean.OnJava1", "com.hezy.bean.OnJava2"})
public class OnMissingClass {
}

因为配置的类都不存在,所以加载了OnMissingClass

总结

本文介绍了Spring Boot中六种选择性加载Bean的方式,按照配置文件加载Bean的方式用的最多。除此六种,Spring还支持其他方式,可在Spring Boot框架中用 @Conditional 为前缀搜索,如下:

相关推荐
Code季风3 分钟前
SQL关键字三分钟入门:WITH —— 公用表表达式让复杂查询更清晰
java·数据库·sql
二闹14 分钟前
我为什么躺平?因为代码自己会“飞”呀!
spring boot·后端·运营
沿着缘溪奔向大海18 分钟前
蓝牙数据通讯,实现内网电脑访问外网电脑
java·爬虫·python·socket·蓝牙
过期动态19 分钟前
MySQL中的常见运算符
java·数据库·spring boot·mysql·spring cloud·kafka·tomcat
mortimer20 分钟前
一次MySQL大表索引删除之旅:从卡死到表损坏再到迁移
数据库·后端·mysql
想用offer打牌22 分钟前
一站式了解责任链模式
java·后端·设计模式·责任链模式
专注VB编程开发20年25 分钟前
C# .NET多线程异步记录日声,队列LOG
java·开发语言·前端·数据库·c#
加瓦点灯29 分钟前
浅谈Java Introspector:理解与应用 Java Bean 内省机制
后端
京东云开发者1 小时前
由 Mybatis 源码畅谈软件设计(八):从根上理解 Mybatis 二级缓存
java
YU_admin1 小时前
Java:常见算法
java·数据结构·算法