【SpringBoot2 从0开始】实现自动配置的过程

简介: 【SpringBoot2 从0开始】实现自动配置的过程

在之前的 helloworld 示例中,已经初步体会到 springboot 自动导入依赖、完成配置的爽快了。


那么,springboot 是如何实现的呢?


一、依赖管理特性


先看下上一篇内容示例中的pom.xml:


<!--导入父工程-->
  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>2.3.4.RELEASE</version>
  </parent>
  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
      </dependency>
  </dependencies>


这里添加了一个父项目,另外只导入了一个依赖spring-boot-starter-web,最后我们所有相关的包就进来了。


1268169-20210827203303046-437490856.png


整个过程中,无需关心导包问题。


1. 父项目


每一个 springboot 工程都有一个父项目,一般都是用来做依赖管理的。


父项目中可能会申明很多的依赖,那么子项目只要继承了父项目,后续在添加依赖的时候就不需要添加版本号了。


以上述为例,父项目使用的是2.3.4.RELEASE的 springboot 版本,所以下面添加的依赖,就无需再写版本号。


(1)父项目如何管理版本


可以按住ctrl,然后单击这个父项目进入一探究竟。


1268169-20210827204232153-634264264.png


进来后发现他也有一个父项目spring-boot-dependencies。


<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-dependencies</artifactId>
    <version>2.3.4.RELEASE</version>
  </parent>


继续进入到spring-boot-dependencies,在下面可以看到一个properties标签:


1268169-20210827204611959-2120587303.png


这里几乎声明了全部我们在开发中可能会用到的 jar 包的版本。


继续往下可以看到具体的依赖管理dependencyManagement,这里引用的就是properties里申明的版本。


1268169-20210827205004314-1672685154.png


举个例子:


左侧我看到有个包是logback,那么就在里面搜索下,发现这里定义好的版本就是1.2.3。


1268169-20210827205135156-1219726423.png


所以说,父项目的主要功能就是依赖管理,几乎声明了开发中常用的依赖的版本号。


(2)使用指定的版本


如果不要使用自动仲裁出的版本,而使用指定版本也是可以的。


比如 mysql 版本,自动仲裁的结果是8.0.21,但是我只想用5.1.43的版本。


1268169-20210827210218476-1677317287.png


添加一个properties标签,在里面申明版本即可。


<properties>
      <mysql.version>5.1.43</mysql.version>
  </properties>


再看下导入的依赖,就已经变成指定的版本了。


1268169-20210827210328133-1025710252.png


2. 场景启动器


再来看下最开始导入的一个依赖spring-boot-starter-web:


<dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
  </dependency>


后续会见到更多的以spring-boot-starter命名的启动器。在官方文档里也有详细的说明


1268169-20210827211339967-1548275324.png


什么是 starter?


starter 一组需要依赖的集合描述,也就是通常我们只需要引入一个 starter,那么对应的整个开发场景就会引入了。


比如想开始使用 Spring 和 JPA 进行数据库访问,那么就在项目中引入spring-boot-starter-data-jpa依赖项。


另外,注意这里spring-boot-starter-*开头的是官方的启动器命名方式。


这么说还有非官方的?是的,如果你觉得官方给你的 starter 场景还是不能满足你的使用需要,那么你可以自定义 starter。


但是官方推荐自定义的命名方式使用thirdpartyproject-spring-boot-starter。

至于为什么只导入一个 starter 就可以导入整个场景的依赖,其实还是跟上面父项目一样,maven 的依赖特性。


进入到spring-boot-starter-web,往下翻,就可以看到开发 web 场景所用到的依赖了。


1268169-20210827212356711-1915960915.png


所以,以后需要开发哪个场景,只要参考官方文档导入对应的启动器即可。


二、自动配置


这里再回顾一下之前的 helloworld 项目中,springboot 自动配置好了哪些东西:


  • 自动配好 tomcat
  • 自动配好 springMVC
  • 自动配好 web 常见功能,比如:字符编码问题
  • 默认的包结构:主程序所在包以及下面所有子包里的组件都会被默认扫描
  • 各种配置拥有默认值
  • 按需加载所有自动配置项
  • ......


1. 自动配置组件


不管自动配置好什么,步骤都是:先引入、再配置。


比如 tomcat,那么前提是先引入了 tomcat 依赖,这就由上面第一部分内容所讲的依赖管理完成,在引入了 web starter 后,自动引入场景。


自动引入了场景,也就引入了这个场景下所用到的各种 jar 包,接下来就是要配置这些内容,比如 tomcat、springMVC 等等。


拿 springMVC 举例,在之前要使用 springMVC,肯定要配置DispatcherServlet,帮我们拦截所有请求。


<servlet>
        <servlet-name>springMVC</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springMVC.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>


现在看下之前的 helloworld 应用中,springboot 是在哪里帮我们做好配置的。

先看主程序类:


// 标记这是一个 springboot应用,这个类是主程序类,所有启动的入口
@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        SpringApplication.run(MainApplication.class, args);
    }
}


可以创建个本地变量(alt+enter),可以看到这个是个ConfigurableApplicationContext类型。


1268169-20210828085442417-76741580.png


@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        ConfigurableApplicationContext run = SpringApplication.run(MainApplication.class, args);
    }
}


可以使用getBeanDefinitionNames()方法,查看里面包含了哪些容器,遍历打印出来。


@SpringBootApplication
public class MainApplication {
    public static void main(String[] args) {
        // 返回IOC容器
        final ConfigurableApplicationContext run = SpringApplication.run(MainApplication.class, args);
        // 查看容器里的组件
        final String[] beanDefinitionNames = run.getBeanDefinitionNames();
        for (String name: beanDefinitionNames) {
            System.out.println(name);
        }
    }
}


接下来启动应用,看下控制台输出。


1268169-20210828090144416-1946986780.png


在控制台输出里ctrl+F搜索下DispatcherServlet:


1268169-20210828090305308-61863662.png


发现 IOC 容器中已经有了对应的组件。


2. 默认的包结构


主程序所在包以及下面所有子包里的组件都会被默认扫描,所以我们不需要配置开启组件扫描,也可以正常使用。


但是要注意这里的范围:


1268169-20210828091223862-1810626469.png



示例中就是com.pingguo.boot包下以及所有子包都可以自动扫描。


如果你就是要放到外面,还希望被扫描到,怎么办?


那么可以使用主程序类中@SpringBootApplication注解中的一个属性scanBasePackages,扩大包的范围即可:


@SpringBootApplication(scanBasePackages = "com.pingguo")
public class MainApplication {
    public static void main(String[] args) {
... ...


3. 各种配置拥有默认值


比如 tomcat端口,在application.properties配置文件里使用 idea 输入的时候,就可以看到带有默认值8080:


1268169-20210828092641254-1194879855.png


点击进去可看到后面都是绑定了对应的 java 类。


1268169-20210828093029792-378296443.png


配置文件的值最终会绑定在对应的类上,这个类会在容器中创建对象。


4. 按需加载所有自动配置项


比如应用中只引入了spring-boot-starter-web,那么就只有web场景的自动配置才会开启。


springboot 中的所有自动配置,都在这里:


<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-autoconfigure</artifactId>
    <version>2.3.4.RELEASE</version>
    <scope>compile</scope>
  </dependency>


点击spring-boot-starter-web可以找到spring-boot-starter,再进入其中就可以看到spring-boot-autoconfigure。


三、小结


经过上面的步骤,我们开发应用就基本可以做到 0 配置,既方便又快捷。


我理解是,springboot 通过各种巧妙的封装,把你可能要用到的场景下的一切都准备好,你需要用直接申明一下(引入场景)就好。


帮助我们彻底摆脱配置地狱,专注于业务。

相关文章
WXM
|
存储 缓存 Java
|
Java 开发工具 git
SpringBoot(二):springboot自动装配之SPI机制
上篇文章我们介绍了springboot启动过程中涉及的核心类及其功能,我们知道springboot相较于spring的一大特性就是**自动装配**,那么自动装配是怎么具体实现的呢? 其实在实现自动装配上springboot采用了多种方案结合的,比如基于spring的扩展点的自动属性注入等,还有提供了一套SPI机制让程序自动可插拔的装配。 本文我带大家重点 了解一下**SPI机制**的实现原理。
672 2
|
NoSQL Java Redis
springboot2原理实战(18)--自定义starter
springboot2原理实战(18)--自定义starter
378 0
springboot2原理实战(18)--自定义starter
|
21天前
|
人工智能 JSON API
全网刷屏的 Jev 模型正式开放!一手实战测评 + 保姆级教程
全网爆火的 Jev 模型是什么?有什么用?怎么使用?怎么接入 AI 编程工具?效果真的好么?傻子可懂的 Jev 保姆级实战教程 + 项目实战测评来啦
9029 28
|
19天前
|
人工智能 并行计算 PyTorch
秋叶 ComfyUI 2026 整合包 v3.2 完整部署教程:Python 3.13 + Torch 2.13 全栈升级
秋叶aaaki ComfyUI 2026年8月整合包v3.2正式发布!全面升级Python 3.13.11、PyTorch 2.13.0+cu130及ComfyUI v0.30.2,原生支持MiniMax H3、Wan 2.2、Qwen-Image-2.1等2026主流音视频/图像模型,解压即用,无需环境配置。
4004 16
|
19天前
|
人工智能 测试技术 API
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
Jev是TypeSafe AI推出的“系统一模型”,不生成文本,专做毫秒级结构化决策:Choice(多选)、Score(打分)、Noul(是非概率)。响应快193倍、成本低444倍,适合工单路由、内容审核、测试定级等高频判断场景。
2320 4
最近全网爆火的 Jev 到底是什么?适合干什么、怎么用,一篇讲透!
|
7天前
|
存储 人工智能 并行计算
大模型本地部署终端选型方法论:以 Qwen3.8-27B 为例的四档分层完整流程
本文提出一套大模型本地部署终端选型方法论:定约束、定档位、定框架、定参数四步决策法,配合入门、主力、质量、无损四档分层模型。以 Qwen3.8-27B 实测数据为例,逐环节解读显存、带宽、存储、散热、系统、预算等要素,给出面向不同预算的优选方案、决策自查清单与市场观察框架。文末前瞻 AI 笔记本的 CPU+GPU 与统一内存两条路线,论证四步决策法在新品类上的延续性。
|
5天前
|
人工智能 JSON 自然语言处理
2026 年 Jev 决策模型深度拆解:原理解读、实战测评与保姆级落地教程
有一款特殊AI模型在开发者圈子刷屏,它摒弃传统大模型擅长的对话聊天能力,专注做高速结构化决策,它就是TypeSafe AI推出的Jev模型。该模型由ChatGPT共同发明人Diogo Almeida主导研发,定位为**System One Model(系统一模型)**,对标人类大脑快速直觉判断的思维模式,在响应延迟、调用成本、结构化输出稳定性上相比传统生成式大模型有着巨大差异。本文会完整拆解Jev底层原理、三大核心原语能力、适用业务场景,同时提供可直接运行的curl、Python代码示例,并且结合多组实测数据,客观分析模型优势与能力边界,帮助普通开发者和AI应用从业者快速上手落地。
473 1
|
13天前
|
人工智能 Linux 开发者
【2026国内使用】Codex安装过程一篇讲透(Win/Mac/Linux全支持)
Codex是OpenAI推出的AI编程智能体,可读取本地项目、理解需求并自动修改代码。支持桌面GUI、命令行(CLI)及VS Code/Cursor插件三种形态,覆盖可视化操作、终端高效开发与编辑器无缝集成场景,助开发者用自然语言驱动编码全流程。(239字)
1052 2
【2026国内使用】Codex安装过程一篇讲透(Win/Mac/Linux全支持)