Java快速开发框架居然没用条件化配置

JAVA快速开发框架大比拼:Jeesite、JeecgBoot、SmartAdmin、若依的深度剖析 Jeesite框架以其全面的功能支持和经典架构闻名。它涵盖了用户权限管理、数据字典、表单设计等企业级应用所需的多项功能,并采用SSH或SSM架构,技术成熟稳定。Jeesite通过插件化方式扩展功能,灵活性高。Jeesite、JeecgBoot、SmartAdmin和若依这四个Java快速开发框架各有其独特的优势和特点。开发者在选择时,应根据项目的实际需求、技术栈的熟悉程度以及团队的技术实力等因素进行综合考虑。 阅读详情

深入理解 Spring Boot 条件化配置:从原理到实践

目前已经构建了 tikrok反向代码,准备设计一个集支付、SSO等中间件的快速开发框架,按需扩展就用到了条件配置,故有如下文章,以温故知新。

在构建可扩展、灵活的 Spring Boot 应用程序时,条件化配置(Conditional Configuration)是一项核心技能。它允许我们根据运行时环境、类路径依赖、配置属性等条件,动态决定是否加载某个 Bean、配置类甚至整个自动配置模块。这种机制是 Spring Boot “约定优于配置”理念的重要支撑,也是其自动配置(Auto-configuration)能力的基石。

本文将深入剖析 Spring Boot 中各种条件注解的实现原理、使用场景及最佳实践,助你构建更智能、更健壮的应用。


一、核心机制:@Conditional

一切条件化配置的根源在于 Spring Framework 4.0 引入的 @Conditional 注解。它是一个元注解(meta-annotation),作用于 @Configuration 类、@Component 类或 @Bean 方法上,用于指定一个或多个 Condition 接口的实现类。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface Conditional {
    Class<? extends Condition>[] value();
}

自定义 Condition 的实现

要实现自定义条件逻辑,只需实现 org.springframework.context.annotation.Condition 接口:

public interface Condition {
    boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}
  • ConditionContext:提供访问 BeanFactory、Environment、ClassLoader、ResourceLoader 等上下文信息。
  • AnnotatedTypeMetadata:提供被注解元素(类或方法)的元数据,如注解属性。
示例:自定义条件
public class OnOsCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String os = context.getEnvironment().getProperty("os.name");
        return os != null && os.toLowerCase().contains("linux");
    }
}

// 使用
@Configuration
@Conditional(OnOsCondition.class)
public class LinuxOnlyConfig {
    // 仅在 Linux 系统下加载
}

虽然可以自定义,但 Spring Boot 已提供了一套开箱即用的 @ConditionalOn... 注解,覆盖了绝大多数场景。


二、Spring Boot 内置条件注解详解

以下注解均位于 org.springframework.boot.autoconfigure.condition 包中,均由 @Conditional 派生。

1. @ConditionalOnProperty:基于配置属性

用途:根据 application.properties 或 application.yml 中是否存在某个属性及其值来决定是否加载。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {
    String[] value() default {}; // 等同于 name
    String[] name() default {}; // 属性名,支持点分格式,如 "my.feature.enabled"
    String havingValue() default ""; // 期望的值,若为空,则只要属性存在且非 false/null 即满足
    boolean matchIfMissing() default false; // 当属性未定义时是否匹配
}
使用示例
# application.yml
app:
  cache:
    enabled: true
    type: redis
@Configuration
@ConditionalOnProperty(name = "app.cache.enabled", havingValue = "true")
public class CacheConfig {

    @Bean
    @ConditionalOnProperty(name = "app.cache.type", havingValue = "redis")
    public Cache redisCache() {
        return new RedisCache();
    }

    @Bean
    @ConditionalOnProperty(name = "app.cache.type", havingValue = "ehcache")
    public Cache ehCache() {
        return new EhCache();
    }
}

注意:matchIfMissing = true 表示当属性未配置时也视为满足条件。适用于提供默认行为的场景。


2. @ConditionalOnClass / @ConditionalOnMissingClass

用途:检查类路径中是否存在(或不存在)指定的类。常用于根据依赖是否存在来启用功能。

@ConditionalOnClass(RedisTemplate.class)
@Configuration
public class RedisAutoConfig {
    // 仅当 spring-data-redis 在 classpath 时加载
}

@ConditionalOnMissingClass("com.example.LegacyService")
@Configuration
public class ModernServiceConfig {
    // 当旧类不存在时才加载新实现
}

底层实现:通过 ClassLoader 检查类是否可加载。注意:这些注解不加载类,仅检查其存在性,避免触发不必要的静态初始化。


3. @ConditionalOnBean / @ConditionalOnMissingBean

用途:根据 Spring 容器中是否存在(或不存在)特定类型的 Bean 来决定是否创建 Bean。这是实现“默认实现 + 可覆盖”模式的关键。

// 自动配置中提供默认实现
@Bean
@ConditionalOnMissingBean // 容器中没有 MyService 类型的 Bean 时才创建
public MyService defaultMyService() {
    return new DefaultMyService();
}
精确控制
  • value():指定 Bean 的类型。
  • name():指定 Bean 的名称。
  • search():指定搜索范围(当前配置类之前定义的 Bean,或整个容器)。
@Bean
@ConditionalOnMissingBean(type = "com.example.CustomService")
public MyService fallbackService() { ... }

重要:@ConditionalOnMissingBean 通常用于 @Configuration 类中的 @Bean 方法,且该配置类应被 @AutoConfiguration(或 @Configuration + @Conditional)包裹,并通过 spring.factories 或 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 注册,以确保在用户自定义 Bean 之后处理。


4. @ConditionalOnExpression

用途:使用 SpEL(Spring Expression Language) 表达式进行复杂条件判断。

@Configuration
@ConditionalOnExpression("${feature.toggle:true} && '${spring.profiles.active}'.contains('prod')")
public class ProdFeatureConfig {
    // 仅在 feature.toggle=true 且 active profile 包含 prod 时加载
}

注意:表达式中的属性需确保存在,否则可能抛出异常。建议搭配默认值(如 ${xxx:defaultValue})。


5. @ConditionalOnResource

用途:检查指定资源(如文件、classpath 资源)是否存在。

@Configuration
@ConditionalOnResource(resources = "classpath:my-config.properties")
public class ExternalConfigLoader {
    // 仅当 classpath 下存在 my-config.properties 时加载
}

6. @ConditionalOnWebApplication / @ConditionalOnNotWebApplication

用途:判断当前应用是否为 Web 应用(Servlet 或 Reactive)。

@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.SERVLET)
@Configuration
public class ServletWebConfig { ... }

@ConditionalOnWebApplication(type = ConditionalOnWebApplication.Type.REACTIVE)
@Configuration
public class ReactiveWebConfig { ... }

7. @Profile:基于激活的 Profile

虽然不属于 @ConditionalOn... 系列,但 @Profile 本质上也是一种条件化配置:

@Configuration
@Profile("dev")
public class DevDatabaseConfig {
    // 仅在 dev profile 激活时生效
}

原理:@Profile 内部通过 @Conditional(ProfileCondition.class) 实现。


三、条件注解的组合与优先级

多个条件注解可以叠加使用,所有条件必须同时满足(逻辑 AND):

@Bean
@ConditionalOnClass(JdbcTemplate.class)
@ConditionalOnProperty(name = "db.feature.enabled")
@ConditionalOnMissingBean
public DatabaseService databaseService() {
    return new JdbcDatabaseService();
}

只有当:

  1. JdbcTemplate 在 classpath 中;
  2. db.feature.enabled=true;
  3. 容器中没有 DatabaseService 类型的 Bean;

该 Bean 才会被创建。

若需实现 OR 逻辑,需自定义 Condition 或使用 @ConditionalOnExpression。


四、最佳实践与注意事项

✅ 推荐做法

  1. 自动配置中优先使用 @ConditionalOnMissingBean:允许用户轻松覆盖默认实现。
  2. 避免在条件判断中执行耗时操作:条件在启动时频繁评估,影响启动性能。
  3. 明确文档化条件逻辑:在注释或文档中说明配置生效的前提。
  4. 测试条件配置:使用 @SpringBootTest 结合不同的 properties 或 @ActiveProfiles 验证不同场景。

⚠️ 常见陷阱

  • @ConditionalOnMissingBean 的评估时机:它只检查当前已注册的 Bean。如果自动配置类加载顺序不当,可能导致误判。可通过 @AutoConfigureAfter / @AutoConfigureBefore 控制顺序。
  • 类加载问题:@ConditionalOnClass 使用独立的类加载器检查,避免触发静态代码块,但若条件类本身依赖其他类,可能因类加载失败而误判。
  • 属性占位符解析:在 @ConditionalOnExpression 中使用 ${} 时,确保属性已加载(通常没问题,但复杂情况下需注意)。

五、总结

Spring Boot 的条件化配置机制为我们提供了强大的运行时决策能力,使框架和应用能够按需加载、灵活适配不同环境与依赖。掌握 @ConditionalOnProperty、@ConditionalOnClass、@ConditionalOnMissingBean 等核心注解的使用与原理,是开发高质量 Spring Boot Starter 或构建可维护企业级应用的关键。

通过合理运用这些注解,你可以:

  • 实现插件化架构;
  • 支持多环境无缝切换;
  • 提供默认实现同时允许用户定制;
  • 避免因缺少依赖导致的启动失败。

条件化配置不仅是 Spring Boot 的魔法源泉,更是你编写智能、健壮、用户友好的 Java 应用的利器。


延伸阅读:

代码示例已通过 Spring Boot 3.x 验证。如需完整示例项目,可留言索取。

Magic API:Java接口的快速开发神器 Magic API是一个基于Java的接口快速开发框架,它提供了简洁易用的UI界面,通过该界面可以方便地编写接口,并自动映射为HTTP接口。使用Magic API,我们无需定义Controller、Service、Dao、Mapper、XML、VO等Java对象,即可快速完成常见的HTTP API接口开发。Magic API的官网地址为:https://www.ssssssss.org/,其中包含了详细的文档和示例,供开发者参考。 阅读详情

相关推荐

构建高效Android应用的快速开发框架指南

本文还有配套的精品资源,点击获取 简介:快速开发框架在Android应用开发中起到了提高效率、减少重复工作的作用。它通过封装常用功能模块和设计模式,简化了代码编写过程。本指南旨在介绍如何利用这些工具来集中精力于业务逻辑而非基础架构搭建,包括对框架源码的理解、核心组件功能分析和最佳实践的掌握。此外,指南还包括组件化、架构模式、依赖注入、自动化构建、网络请求、数据持久化、UI组...

weixin_42376614的博客 1848

CUBA - 一个卓越的 Java 快速开发框架

文章目录什么是 CUBA 框架(CUBA Framework)?一个企业级快速开发框架CUBA 架构介绍CUBA 框架的能力开箱即用的功能和界面可扩展性其他CUBA 界面预览CUBA Studio付费部分用 CUBA 的好处在哪里节省人力开发积极支持一直在进化中文资源关于作者欢迎使用Markdown编辑器新的改变功能快捷键合理的创建标题,有助于目录的生成如何改变文本的样式插入链接与图片如何插入一段...

码客的江湖 3861

ESP-SR实战:从零搭建智能语音唤醒与命令识别系统

本文详细介绍了如何利用乐鑫ESP-SR框架,从零开始搭建一个完整的离线智能语音交互系统。内容涵盖硬件选型(推荐ESP32-S3与数字麦克风)、开发环境配置(ESP-IDF与ESP-ADF),并深入解析了AFE声学前端、WakeNet唤醒词检测和MultiNet命令词识别三大核心模块的工作原理与实战配置。通过具体的代码示例和调试技巧,指导开发者快速实现高识别率的语音唤醒与命令控制功能。

weixin_29161785的博客 302

Java的开源快速开发框架

作者:HPioneer 链接:https://www.zhihu.com/question/51117504/answer/1373939385 来源:知乎 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。 1、若依 ruoyi,全代码开源的,可免费使用。 官网地址:https://ruoyi.vip/ 体验地址:登录若依系统 如果你想了解,不妨看下下面2个文章,深入了解下若依: HPioneer:专题:快速开发那点事儿 | 无代码开发?? RUOYI框架教程(一) ht.

b_just的博客 2337

HP SPP download

是一个全面的系统软件和固件更新解决方案,以单个ISO映像的形式提供。该解决方案使用智能更新管理器(SUM)作为部署工具。

极致,细节 9864

最优化理论与自动驾驶(三):LQR原理、公式及代码演示

LQR 是基于线性系统和二次型代价函数的最优控制方法,在实际工程应用中,我们一般采用离散时间系统的LQR设计,其目标是通过设计反馈控制律,使系统在离散时间步长内稳定运行,最小化某个二次型代价函数。给定一个离散时间系统,其状态和控制输入通过以下方程表示:是时刻k的系统状态,是时刻k的控制输入,是状态转移矩阵,是输入矩阵。系统描述的物理意义:系统状态通过矩阵A演变到下一时刻,同时控制输入通过矩阵B影响系统的状态。

a8598671的博客 4597

Java开发常用4大框架及快速开发框架

F2BPM低代码开发框架采用SpringBoot+Vue前后端分离的架构,后端基于SpringBoot技术栈,前端使用Vue3构建可视化界面。支持多租户部署和数据逻辑隔离,适配国产化环境(如达梦数据库、麒麟操作系统)

yinzheshijie的专栏 1279

WSL2不能上网,Failed to connect to github.com port 443问题解决方案

WSL2不能上网: 问题:ping外网无效 例如:ping www.baidu.com失败 解决方案: 在wsl: $sudo vi /etc/wsl.conf wsl.conf: [network] generateResolvConf = false 在PowerShell: $sudo vi /etc/etc/resolv.conf resolv.conf: # This file was automatically generated by WSL. To stop automatic gen

Jason_Chen__的博客 9528

快速开发框架若依的基础使用详解

为什么选?目的是为了提高开发效率,至于能不能提高,得实践才能知晓。若依的官网:http://www.ruoyi.vip/是一个快速开发框架,典型的一个后台管理系统。RuoYi-Vue是一个 Java EE 企业级快速开发平台,基于经典技术组合(Spring Boot、Spring Security、MyBatis、Jwt、Vue),内置模块如:部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置;支持集群,支持多数据源,支持分布式事务。

砷碲 - Shendi 9136

功能安全入门:手把手教你用IEC 62380标准计算芯片失效率(附SN 29500对比)

本文深入解析了IEC 62380标准在芯片失效率计算中的应用,对比了SN 29500的差异,并提供了实战案例和避坑指南。通过详细的参数获取方法和分步计算演示,帮助功能安全工程师准确评估芯片可靠性,确保设计符合安全要求。特别适合汽车电子和工业控制领域的专业人士参考。

weixin_30363981的博客 322

动态数据脱敏技术分析

在当前国内信息安全热潮中,数据脱敏作为数据安全的重要一环得到了业界的认可与重视。早在2012年,数据脱敏首次作为一个单独的魔力象限由Gartner发布,Gartner在2014年又提出了:按照数据使用场景,将数据脱敏分为静态数据脱敏(Static data masking-SDM )与动态数据脱敏(Dynamic data masking-DDM )。 可能有人望文生义,认为动态数据脱敏一定比静态数据脱敏高级。非也非也,静态or动态,取决于脱敏的使用场景,主要是以使用场景为由来选择合适的数据脱敏的模式。 本

美创科技的博客 4680

基于Java的快速开发框架(Diboot)

Diboot是一个基于Java的快速开发框架,主要用于简化企业级应用开发的流程。它采用了一系列的设计模式和技术,帮助开发者更高效地构建高质量的Web应用、后端服务等各类软件系统。例如,在开发一个包含用户管理、权限控制、数据存储和展示等功能的企业资源规划(ERP)系统时,Diboot可以发挥很大的作用。其2.2.0版本在IAM模块增加了组织架构管理、岗位管理、数据权限控制等功能,可通过简单的配置和代码生成,实现对数据权限的精细化管理。

weixin_43156294的博客 1743

基于uniapp开发PDA扫码枪APP:实现RFID批量扫描读取功能

基于uniapp的PDA扫码枪APP开发实战,实现高效RFID读取功能,uniapp整合PDA硬件的实践分享,基于uniapp的PDA端RFID批量扫描方案开发

商务合作 / 项目定制 / 学习交流。个人vx:lovely_wml 1万+

如何快速提升Java开发效率:Nutz框架终极完整指南

作为一名Java开发者,你是否曾经为繁琐的配置和复杂的框架学习而头疼?Nutz框架正是为了解决这些问题而生的终极解决方案。Nutz是一个轻量级的Java Web框架,集成了MVC、IOC、AOP、DAO和JSON等核心功能,让Java开发变得更加简单高效。无论你是初学者还是资深开发者,Nutz都能显著提升你的开发效率和代码质量。 ## 🔥 Nutz框架核心优势解析 ### 一站式解决方案,告

gitblog_00454的博客 916

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

文档:亲测可用解决vnc灰屏,黑屏,鼠标大黑叉情况

主要解决vnc-viewer灰屏,黑屏,鼠标大黑叉等现象,详细见文档。

Java Spring Boot 开发框架

Spring Boot是由Pivotal团队开发的一款开源框架,它建立在Spring框架的基础上,利用了Spring的各种功能和扩展,使得开发者能够更快速、更轻松地创建和部署应用程序。Spring Boot通过自动配置、快速启动、内嵌服务器等特性,大大简化了Java应用程序的开发流程。Spring Boot是一款强大的Java开发框架,它以简化和加速Java应用程序开发的方式受到了广大开发者的青睐。

hitpter的专栏 4235

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

自己写的一个后端快速开发框架

码云地址 https://gitee.com/huhuanan/mo.test 项目介绍 M快速开发框架是一款java+mysql的后台框架,开发快速、配置简单、代码简易、简单轻量、功能强大。包含后台用户、角色与机构的权限设置。后台列表和编辑页面可用注解编写,样式统一美观。 后台测试地址: http://test.ostudio.cc/admin admin 123456 (请勿修改密码,如不能登录请联系我,最下面有联系方式) 项目技术 项目后端代码大部分为自己编写,web.xml配置有监听器和过滤器,

douzhi9124的博客 1235

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

Java开发环境安装与配置(快速配置)

知识的广度来自知识的深度,学习如果不成体系那是多可怕的一件事儿,希望我们在未来的学习道路上坚守初心,不要给自己留下遗憾,以自己喜欢的方式生活,做自己喜欢做的事,宠爱自己,做一个独一无二的自己! 对于文章中出现的任何错误请大家批评指出,会及时做出修改! 有任何想要讨论和学习的问题可联系我:cittaksana@qq.com Java开发环境安装与配置JDK介绍Java与JDK的关系下载JDK安装JDK环境变量配置1. 配置位置2.JAVA_HOME3.CLASSPATH4.Path进入命令提示符测试1.

Archie_Could的博客 3万+

若依框架快速开发功能的使用

若依框架快速开发功能写毕设课设 若依快速开发框架要提前准备好的工作: 1.下载若依官网的代码并正常运行 (导入项目之后设置里Maven路径改一下再刷新pom文件,最后改数据库密码就ok) 2.对自己毕设需求分析,合理建表 (建表规范:实体类表需要有自增id、create_by,update_by,update_time字段,并且符合第三范式。规范建表后面写论文会加分噢) 3.任何程序都应该从底层做起,即先做数据库设计,再去写代码,最后才到界面 (设计思路) 代码生成: 1.首先自己的数据库表里面需要有中文注

My note 4591

java快速开发框架的功能怎么样?

java快速开发框架的功能怎么样?这也是很多客户和粉丝经常问到的问题,今天,我们就在这篇文章中寻找答案。

Gzlcxxjs的博客 404

Java快速开发框架大比拼:Jeesite 、jeecgBoot、smartAdmin、若依全方位解析

本文对比分析了Java开发领域中的四个流行快速开发框架:Jeesite、JeecgBoot、SmartAdmin和若依。Jeesite以其成熟稳定和扩展性强适用于企业级信息管理系统和中大型项目;JeecgBoot凭借快速开发和丰富的插件适合快速原型开发和中小项目;SmartAdmin的轻量级和前后端分离特性使其成为小型Web应用和对性能要求高的系统的优选;若依则因其功能全面和代码简洁易读,适合大型企业级项目和通用型后台管理系统。开发者应根据项目需求、业务复杂度、性能要求和开发时间等因素,选择最合适的框架以提

chenchuang0128的博客 5748

Spring Boot核心特性与自动配置:简化配置、提高开发效率

自动配置(Auto Configuration)Spring Boot能够根据项目依赖和环境自动配置应用所需的各种组件,极大简化了传统Spring开发中繁琐的XML和Java配置过程。内嵌Web服务器Spring Boot自带了Tomcat、Jetty、Undertow等内嵌Web服务器,开发者无需进行繁琐的服务器安装和配置,直接打包为一个可执行的JAR文件即可运行。起步依赖(Starters)

一碗黄焖鸡三碗米饭的博客 4282

四款JAVA快速开发平台推荐

JBoss Seam JBoss Seam,算得上是Java开源框架里面最优秀的快速开发框架之一。 Seam框架非常出色,尤其是他的组件机制设计的很有匠心,真不愧是Gavin King精心打造的框架了,虽然看起来还是有些缺陷,但是做企业应用项目的话,Seam是一个很棒的选择,作为程序员来说,要比用 Spring/Hibernate/Struts省心的多,更能够把精力放在业务逻辑的编写上面,开发效率...

疯狂石子的博客 1万+

java开发_几款java快速开发平台推荐

JBoss SeamJBoss Seam,算得上是Java开源框架里面最优秀的快速开发框架之一。Seam框架非常出色,尤其是他的组件机制设计的很有匠心,真不愧是Gavin King精心打造的框架了,虽然看起来还是有些缺陷,但是做企业应用项目的话,Seam是一个很棒的选择,作为程序员来说,要比用 Spring/Hibernate/Struts省心的多,更能够把精力放在业务逻辑的编写上面,开发效率也很...

weixin_39946364的博客 1371

若依快速开发框架使用教程

若依快速开发框架使用教程 1. 项目介绍 若依快速开发框架是一款基于SpringBoot的轻量级Java快速开发框架。它适用于各种Web应用程序,如网站管理后台、网站会员中心、CMS、CRM、OA等。框架采用Spring、MyBatis、Shiro等核心技术,无其他重度依赖,使得系统更加精简且易于上手。若依框架提供了丰富的内置功能,包括用户管理、部门管理、岗位管理、菜单管理、角色管理、字典管理、参...

gitblog_00560的博客 1046
上一篇: Redis 经典高级数据结构实战:HyperLogLog、Bitmap 与 GEO
下一篇: 监控报警内存 90%+排查记录
旷野说
博客等级 码龄9年 361粉丝 86原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值