在这里插入图片描述


在使用 Spring Boot 进行开发时,我们常常会引入诸如 spring-boot-starter-webspring-boot-starter-data-jpa 等依赖,从而快速开启相关功能模块。但你是否思考过这些 Starter 是如何构建的?如果我们要开发自己的 Starter,又该如何入手?

本文将从原理与实践两个角度,详细解析 Spring Boot Starter 的生成机制,并带你一步步创建一个自定义 Starter。


一、什么是 Spring Boot Starter?

Spring Boot 的 Starter 本质上是一组 预定义的依赖集合,旨在通过统一封装常用的配置、Bean 和依赖库,降低上手成本,提高项目的一致性与开发效率。

常见 Starter 示例:

Starter 名称功能
spring-boot-starter-web包含 Spring MVC、Jackson、嵌入式 Tomcat 等
spring-boot-starter-data-jpa包含 Spring Data JPA、Hibernate 等
spring-boot-starter-test包含 JUnit、Mockito 等测试库

本质:

Starter 本质上就是一个 Maven 或 Gradle 的普通依赖,通常由以下结构组成:

  • 自动配置类(@Configuration + @Conditional*
  • Spring Factories 注册文件
  • 相关依赖

二、Starter 的核心机制原理

1. 自动配置(Auto Configuration)

Spring Boot 的自动配置依赖于两个核心组件:

  • @EnableAutoConfiguration
  • spring.factories 中配置的自动配置类

Spring Boot 启动时会扫描依赖中的 META-INF/spring.factories 文件,并加载其中声明的 EnableAutoConfiguration 类。

# spring-boot-autoconfigure 包中
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.autoconfig.MyServiceAutoConfiguration

2. 条件注解(@Conditional 系列)

Starter 中的自动配置通常不是强制生效的,而是基于条件。例如:

@Configuration
@ConditionalOnClass(MyService.class) // 仅当 classpath 中存在该类时才生效
@ConditionalOnMissingBean(MyService.class) // 若用户未定义此 bean 时自动配置
public class MyServiceAutoConfiguration {@Beanpublic MyService myService() {return new MyService();}
}

Spring Boot 提供了丰富的条件注解,如:

  • @ConditionalOnClass
  • @ConditionalOnMissingBean
  • @ConditionalOnProperty
  • @ConditionalOnResource

这使得 Starter 能够根据用户配置进行动态装配,具备高度灵活性。


三、自定义 Spring Boot Starter 实践

1. 创建两个模块

我们推荐将 Starter 分为两个模块:

(1)my-spring-boot-starter-autoconfigure
  • 包含核心配置类、Bean、spring.factories
  • 不依赖 Spring Boot Starter 本身,便于独立测试和复用
(2)my-spring-boot-starter
  • 仅引入 my-spring-boot-starter-autoconfigure 与所需依赖(如日志库、Spring Web 等)
  • 供外部项目使用

2. 编写自动配置类

@Configuration
@ConditionalOnClass(MyService.class)
@ConditionalOnMissingBean
public class MyServiceAutoConfiguration {@Beanpublic MyService myService() {return new MyService("默认配置");}
}

3. 注册自动配置类

my-spring-boot-starter-autoconfigureresources/META-INF/spring.factories 文件中:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.autoconfig.MyServiceAutoConfiguration

Spring Boot 2.7 及以后版本推荐使用 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

4. 打包发布

分别将 starter-autoconfigurestarter 打成 jar 包,并发布至私服或 Maven 中央库。


四、整合属性配置(可选)

为了增强 Starter 的可配置性,可以整合 @ConfigurationProperties

示例:

@ConfigurationProperties(prefix = "my.service")
public class MyServiceProperties {private String name = "默认名称";// getter & setter
}@Configuration
@EnableConfigurationProperties(MyServiceProperties.class)
public class MyServiceAutoConfiguration {@Beanpublic MyService myService(MyServiceProperties properties) {return new MyService(properties.getName());}
}

用户项目中即可通过 application.yml 覆盖默认配置:

my:service:name: 自定义名称

五、与 Spring Boot 官方 Starter 的区别

官方 Starter自定义 Starter
功能强大、通用性广适用于内部统一配置
发布在 Maven Central可发布至公司私服
通常有多个子模块结构自由,便于维护

六、结语

Spring Boot Starter 是实现模块化、自动化配置的关键利器。通过本篇内容,我们系统性地理解了 Starter 的构建原理及其核心机制,并掌握了开发一个自定义 Starter 的完整流程。

掌握 Starter 的构建技巧,不仅能提升开发效率,也为你在团队中构建标准化基础组件打下坚实基础。


附:自定义 Starter 项目结构示意

my-spring-boot-starter/
├── my-spring-boot-starter/
│   └── pom.xml (依赖 my-spring-boot-starter-autoconfigure)
└── my-spring-boot-starter-autoconfigure/├── src/main/java/│   └── com/example/autoconfig/│       ├── MyServiceAutoConfiguration.java│       └── MyServiceProperties.java├── src/main/resources/│   └── META-INF/│       └── spring.factories└── pom.xml

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如若转载,请注明出处:http://www.pswp.cn/pingmian/89423.shtml
繁体地址,请注明出处:http://hk.pswp.cn/pingmian/89423.shtml
英文地址,请注明出处:http://en.pswp.cn/pingmian/89423.shtml

如若内容造成侵权/违法违规/事实不符,请联系英文站点网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

阿里云-通义灵码:隐私保护机制—为数据安全筑起铜墙铁壁

免责声明:此篇文章所有内容皆是本人实验,并非广告推广,并非抄袭,该系列继续~每日一句不要感叹自己的平凡,即便是最暗的星星,相与无边的黑暗已是耀眼。一.引言在这个数据如同空气般渗透到生活每个角落的时代…

最小生成树算法详解

最小生成树算法详解一、最小生成树基础概念1.1 生成树与最小生成树1.2 核心性质1.3 应用场景二、Prim 算法:从顶点出发的“生长式”构建2.1 算法原理2.2 Java 代码实现(邻接矩阵版)2.3 复杂度分析三、Kruskal 算法:按边权排序的“…

YOLO 目标检测的改进方法

YOLO目标检测的改进方法可以从模型架构、训练策略、损失函数等多个方面入手,以下是一些常见的改进方法方向及参考文献: 模型架构改进 骨干网络替换:使用更轻量或更强大的网络替换原始骨干网络。轻量级网络如MobileNetV3、ShuffleNetV2等适合…

C++ 程序 AddressSanitizer:DEADLYSIGNAL

GCC && G 操作系统:Ubuntu 22.04 现象:C程序编译时开启ASAN,运行时有几率会出现大量AddressSanitizer:DEADLYSIGNAL 参考文章: https://stackoverflow.com/questions/77894856/possible-bug-in-gcc-sanitizers https://st…

【强化学习】实际部署

环境 Gymnasium 作为环境接口, PyBullet作为物理仿真平台, Stable Baselines3 用于训练算法。 测试框架搭建 以pybullet自带的Cart-pole-v1为例 安装依赖:确保安装了 Gymnasium 和 SB3 ( pip install gymnasium stable-baselines3 ).初始化环…

集训Demo4

创建数据库创建项目基本和视频中的一样我给User添加了vip这个属性,想实现两个令牌通过访问的案例,但遇到了问题一个令牌是密码加用户名的map数组这是它的获取、验证逻辑获取验证另一个令牌是Int vip这是自己写的另一套密钥和方法获取但在验证这里有问题头…

深度优化:Java 慢查询排查与性能调优实战

文章目录🚀 深度优化:Java 慢查询排查与性能调优实战🚨1. 事故全景:从告警到定位🕵️‍♂️1.1 事故时间线📊 1.2 关键指标异常🛠️ 1.3 排查工具链🔍 2. 深度剖析:MySQL…

TF-IDF(Term Frequency - Inverse Document Frequency)

TF-IDF(Term Frequency - Inverse Document Frequency)是一种在信息检索与文本挖掘中非常常用的关键词提取方法,用于衡量一个词在文档集合中的重要性。它的核心思想是:如果一个词在某个文档中出现得频繁,同时在其他文档…

Chrome紧急更新,谷歌修复正遭活跃利用的关键零日漏洞

谷歌已针对桌面版Chrome发布重要稳定渠道更新(版本138.0.7204.157/.158),修复了六个安全漏洞,其中包括一个已被实际利用的漏洞。该更新正在向Windows、Mac和Linux平台推送,预计未来数日或数周内将通过自动更新完成部署…

Typecho插件开发:实现文章字数统计与阅读时长计算功能

文章目录 Typecho文章字数统计与阅读时长计算功能实现指南 1. 功能背景与需求分析 2. 插件设计与实现 2.1 插件基础结构 2.2 插件主逻辑实现 2.3 代码解析与优化 3. 前端展示优化 3.1 CSS样式增强 3.2 多语言支持 4. 高级功能扩展 4.1 数据库表优化 4.2 定时批量处理历史文章 5…

开源短链接工具 Sink 无需服务器 轻松部署到 Workers / Pages

本文首发于只抄博客,欢迎点击原文链接了解更多内容。 前言 Sink 是一款开源免费的短链接生成工具,支持自定义短链接 Slug 以及设置到期时间,并且还可以借助 Cloudflare 的 Analytics Engine 功能分析短链接的统计数据。 最重要的是实现以上这些功能并不需要有自己的服务器,…

嵌入式数据结构之顺序表总结

以下是为嵌入式面试准备的顺序表全面优化指南,结合高频考点、代码规范与嵌入式专项优化技巧,助你系统掌握该知识点。 一、顺序表基础与嵌入式特点 ​本质​ 用连续内存空间存储线性表元素,通过下标实现O(1)随机访问 。 ​嵌入式优势​&#x…

Pytorch下载Mnist手写数据识别训练数据集的代码详解

datasets.MNIST(root./data, trainFalse, downloadTrue, transformtransforms.ToTensor())1. datasets.MNIST这是torchvision.datasets模块中的一个类,专门用于加载MNIST数据集。MNIST是一个著名的手写数字识别数据集,包含60,000个训练样本和10,000个测试…

汽车免拆诊断案例 | 07款丰田Hilux启动故障

故障现象一辆 2007 年的丰田Hilux 2.5L柴油手动挡,行驶里程为23万公里。车主说车辆有很多故障,包括故障灯闪烁、发动机启动后又熄火、短时间运行时发动机还会剧烈抖动异响,从排气管冒出大量烟雾。故障诊断接车之后进行检查,发现发…

黄老师(Exeter University)学术交流

1. 文章结构与核心贡献聚焦 强调明确切入点和核心“亮点”贡献,避免分散,确保至少一项最主要、富有创新的方法。在该贡献点上进行全面充分的实验验证,包括不同模型尺寸、普适性测试,以应对审稿专家的质疑。建议从读者或审稿人角度…

ArcGIS Pro+PS 实现地形渲染效果图

先前关注了B站和小红书博主,设计暴风眼,大神讲的确实好,深感佩服,自己以前的制图仅仅实现了制图,实现了把图放在论文里能凑合,而不是设计。最近抽时间学习了一下大神的合集:ArcGIS Pro实用技法合…

ollma dify 搭建合同审查助手

目录 windows dify: ollma 配置 ollma下载地址: qwen3 模型下载 这个自动下载,下载后自动运行。 配置环境变量:修改监听后很慢 测试命令: 模型配置url: 搭建工作流 windows dify: 下载 dify代码&#xff1a…

解锁 iOS 按键精灵辅助工具自动化新可能:iOSElement.Click 让元素交互更简单

在移动自动化测试与脚本开发领域,精准操控应用元素是核心需求。无论是自动化测试流程、批量操作处理,还是场景化脚本开发,能否可靠地点击指定元素直接决定了自动化任务的成败。在 iOS 自动化操作中,开发者常常面临三大痛点&#x…

【机器学习】AdamW可调参数介绍及使用说明

在 AdamW 算法中调整参数对模型训练过程和最终效果有直接且重要的影响,以下是各关键参数对性能的具体影响总结:AdamW 主要可调参数及其影响说明 1. 学习率 lr 影响: 太大(如 0.01 ~ 0.1):训练过程不稳&…

第一篇htmlcss详细讲解

第一章 HTML标签介绍 第一节 HTML基本结构 <!DOCTYPE html> <html><head><title>标题</title></head><body>文档主体</body></html> HTML 标签是由<>包围的关键词,例:<html> HTML 标签通常成对出现,分…