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 为前缀搜索,如下:

相关推荐
gou123412347 分钟前
【Golang进阶】第八章:并发编程基础——从Goroutine调度到Channel通信实战
开发语言·后端·golang
秋难降9 分钟前
贪心算法:看似精明的 “短视选手”,用好了也能逆袭!💥
java·算法
程序小武10 分钟前
python编辑器如何选择?
后端·python
陈随易12 分钟前
薪资跳动,VSCode实时显示今日打工收入
前端·后端·程序员
阿蒙Amon13 分钟前
C#数字金额转中文大写金额:代码解析
java·mysql·c#
失乐园16 分钟前
电商/物流/IoT三大场景:用MongoDB设计高扩展数据架构的最佳实践
java·后端·架构
五行星辰18 分钟前
Spring AI 实战:用 Java 搞 AI,从此告别调参侠
java·后端
紫菜炒饭18 分钟前
什么??go中的协程池竟然.........
后端
知其然亦知其所以然21 分钟前
不懂 Python?没关系!Easy RAG 让 Java 开发者也能玩转大模型
java·后端·llm
五行星辰23 分钟前
Spring AI 实现 MCP:让 AI 自动管理你的代码质量
java·后端