SpringBoot 的启动引导类真的是 XXApplication 吗?

1. 引导类的“名”与“实”:为什么大家都叫 Application?

Spring Boot 提倡“约定优于配置”的理念。XXXApplication 这个命名方式,本质上是官方文档和绝大多数教程为了统一、规范和易于识别而推广的一种约定。它就像是一个显眼的“入口”路牌,告诉所有开发者:“嘿,项目的起点就在这里!”

所以,回答你的第一个问题:“真的是 XXApplication 吗?”——在约定上,是的;但在语法上,不是。 它的真实身份,是一个被 @SpringBootApplication 注解标记的、包含 main 方法的普通 Java 类。

2. 拆解引导类的“灵魂”:@SpringBootApplication

引导类的强大,并非源自它的名字,而是它头顶的那个神奇的注解——@SpringBootApplication。这个注解本身并不复杂,但它是一个“三合一”的组合注解,是开启 Spring Boot 世界的钥匙。

java

// 一个典型的Spring Boot引导类 @SpringBootApplication // <-- 核心中的核心 public class MyAwesomeApp { public static void main(String[] args) { SpringApplication.run(MyAwesomeApp.class, args); } }

让我们一层层剥开 @SpringBootApplication 的外衣 :

  • @SpringBootConfiguration:它本身又是一个 @Configuration 注解的“马甲”。这意味着,我们的引导类本身就是一个配置类。你可以在这个类里通过 @Bean 注解向 Spring 容器注册额外的 Bean。
  • @ComponentScan:这就是 “组件扫描” 注解。它的默认扫描范围是引导类所在包及其所有子包 。这就是为什么我们通常建议将引导类放在项目的根目录下,比如 com.example.myproject,这样它就能自动扫描到 com.example.myproject.controllercom.example.myproject.service 等子包下的 @Controller@Service 等组件。
  • @EnableAutoConfiguration:这是整个 Spring Boot 框架的灵魂所在,负责开启自动配置。它会根据你在项目类路径中添加的依赖(比如 spring-boot-starter-web),自动推断并配置你需要的 Bean。例如,你添加了 web starter,它就会自动帮你配置好 DispatcherServlet 和内嵌的 Tomcat 服务器。

3. 深度剖析:SpringApplication.run() 里到底发生了什么?

引导类的 main 方法只做了一件事:委托给 SpringApplication.run() 静态方法。但这一行代码背后,是一套极其精巧的启动流程。整个过程可以分为两大阶段:初始化 和 运行 。

3.1 初始化阶段:准备舞台

当调用 run 方法时,会先创建一个 SpringApplication 实例。在这个构造函数中,Spring Boot 会完成一系列“侦查”工作:

  1. 推断应用类型:检查类路径下是存在 DispatcherServlet(传统 Servlet)还是 DispatcherHandler(WebFlux),从而确定应用类型是响应式 Web 还是 Servlet Web,抑或是非 Web 应用 。
  2. 加载初始化器:从 META-INF/spring.factories 文件中加载所有配置的 ApplicationContextInitializer。这些初始化器用于在 Spring 容器刷新前对其进行定制。
  3. 加载监听器:同样从 spring.factories 中加载所有配置的 ApplicationListener。这些监听器会监听启动过程中的不同阶段事件,并执行相应动作 。
  4. 推断主启动类:通过堆栈信息找到含有 main 方法的类,也就是我们的引导类。
3.2 运行阶段:正式开演

初始化完成后,真正的 run() 逻辑开始执行,整个过程充满了事件驱动 。

  • ApplicationStartingEvent:发布应用启动事件。
  • 准备环境 prepareEnvironment():创建 Environment 对象,并加载系统环境变量、JVM 参数以及最重要的 application.properties/yml 配置文件。完成后发布 ApplicationEnvironmentPreparedEvent 。
  • 创建上下文 createApplicationContext():根据初始化阶段推断的应用类型,创建对应的 ApplicationContext(IoC 容器)。例如,对于 Servlet Web 应用,会创建 AnnotationConfigServletWebServerApplicationContext 。
  • 准备上下文 prepareContext():将 Environment 绑定到上下文,执行所有已加载的 ApplicationContextInitializer,并通过 @ComponentScan 将引导类本身作为一个配置源,将其 Bean 定义加载到容器中。之后发布 ApplicationPreparedEvent
  • 刷新上下文 refreshContext():这是 Spring 框架最核心的方法。它会完成所有 Bean 的实例化、依赖注入、初始化,以及最重要的——触发自动配置。Tomcat 等内嵌 Web 服务器也是在此步骤中启动的 。
  • 启动后动作 afterRefresh():执行所有实现了 ApplicationRunner 和 CommandLineRunner 接口的回调类,用于执行启动后的初始化任务 。
  • ApplicationReadyEvent:发布应用已准备就绪事件,应用正式对外提供服务。

4. 进阶探索:引导类还可以这样玩

除了最简单的 SpringApplication.run(),我们还可以通过创建和定制 SpringApplication 对象来实现更精细的控制 。

java

@SpringBootApplication public class CustomizedApp { public static void main(String[] args) { // SpringApplication app = new SpringApplication(CustomizedApp.class); SpringApplication app = new SpringApplication(); app.setPrimarySources(Set.of(CustomizedApp.class)); app.setBannerMode(Banner.Mode.OFF); // 关闭Banner app.setDefaultProperties(Collections .singletonMap("server.port", "8081")); // 设置默认端口 // 添加自定义监听器 app.addListeners(new MyApplicationListener()); ConfigurableApplicationContext context = app.run(args); // ... 可以获取context做一些事情 } }

5. 终极揭秘:Jar 包启动的“障眼法”

当我们把 Spring Boot 项目打成可执行 Jar 包并运行(java -jar myapp.jar)时,引导类的角色变得更加有趣。你可能会想,我明明设置了 MyAwesomeApp 作为主类,为什么启动时还能看到 Spring Boot 的 Banner?

答案是,真正的“引导”另有其人。Spring Boot 的 Jar 包结构是特殊的,它的 META-INF/MANIFEST.MF 文件里定义了真实的入口 :

properties

Main-Class: org.springframework.boot.loader.launch.JarLauncher Start-Class: com.example.myproject.MyAwesomeApp

  • Main-Class:这里配置的是 JarLauncher,它是 Spring Boot 自己提供的引导程序。它的工作是创建自定义的类加载器,从 Jar 包内部的 BOOT-INF/lib 目录下加载所有依赖的 Jar 包。
  • Start-Class:这里才指向我们编写的引导类 MyAwesomeAppJarLauncher 在准备好类加载器后,会通过反射调用 MyAwesomeApp 的 main 方法,从而正式启动我们的 Spring Boot 应用 。

所以,从物理 Jar 包层面看,真正的“引导类”是 JarLauncher;而从业务逻辑层面看,MyAwesomeApp 仍然是当之无愧的“启动引导类”。这是一种巧妙的分层设计。

总结

现在我们可以清晰地回答你的问题了:

  1. 命名约定XXApplication 是官方推荐的命名习惯,但不是强制规定。
  2. 本质核心:引导类的本质是一个被 @SpringBootApplication 注解标记的配置类,它作为组件扫描和自动配置的起点。
  3. 启动原理:引导类通过 SpringApplication.run() 触发一系列复杂的初始化、事件发布和容器刷新流程,最终启动内嵌服务器,完成应用自举。
  4. 终极真相:在打包成可执行 Jar 后,物理上的引导类是 JarLauncher,它负责创建环境并调用我们定义的业务引导类。

Read more

从零开始使用ISSACLAB训练自己的机器人行走

从零开始使用ISSACLAB训练自己的机器人行走

ISAACLAB入门教程 作者:陈维耀 1. 环境配置 1.1 推荐配置 * 操作系统: Ubuntu 22.04 LTS * 显卡: NVIDIA RTX 4080或以上 1.2 ubuntu 22.04 LTS安装 参考ZEEKLOG的Ubuntu 16.04 LTS安装教程,将其中的ubuntu 16.04镜像文件替换为ubuntu 22.04镜像文件,其他步骤保持不变,建议/home与/usr的硬盘容量均不少于200G。 1.3 安装NVIDIA驱动 根据自身显卡型号与操作系统,选择对应的显卡驱动,建议选择550.xxx.xxx版本的显卡驱动,按照教程进行安装即可,安装完成后在终端输入nvidia-smi,若出现以下信息则表示驱动安装成功: Thu Jun 5

By Ne0inhk
2026年IEEE RAL SCI2区,基于熵的多无人机持续监测增量覆盖路径规划,深度解析+性能实测

2026年IEEE RAL SCI2区,基于熵的多无人机持续监测增量覆盖路径规划,深度解析+性能实测

目录 * 1.摘要 * 2.系统模型与问题表述 * 3.多无人机监测框架 * 4.参考文献 * 5.代码获取 * 6.算法辅导·应用定制·读者交流 1.摘要 针对海上油污持续变化与分散分布带来的持续监测难题,本文提出了一种基于熵的增量覆盖路径规划方法(EICPP),通过相邻监测周期的轮廓对比,引入增量覆盖机制,重点关注新出现的油污区域;随后结合均衡区域划分算法,在处理分散油污区域的同时,实现多无人机负载均衡;最后基于熵进行路径规划,在无人机资源受限条件下优先监测高熵区域,从而提升漂移信息新鲜度(DIF)。 2.系统模型与问题表述 油污泄漏动态模型与网格表示 为实现有效的油污监测与应急响应,本文采用 OpenDrift 作为核心仿真工具,结合物理海洋模型、油品风化过程以及真实风场和海流数据,生成油污扩散轨迹。 设监测区域为 A ⊂ R 2 A\subset\mathbb{R}^2 A⊂

By Ne0inhk
OpenDroneMap (ODM) 无人机影像三维模型重建安装及使用快速上手

OpenDroneMap (ODM) 无人机影像三维模型重建安装及使用快速上手

1 文档概述 本文档是指导用户从零开始,使用 OpenDroneMap 对无人机采集的影像数据进行处理,生成三维点云、数字表面模型(DSM)、正射影像图(Orthomosaic)等成果。 本文档的预期读者为拥有无人机航拍影像(JPG/PNG格式)并希望进行三维建模的用户。 2.1 系统运行环境要求 - 操作系统:Windows 10/11, macOS, 或 Linux (推荐 Ubuntu)。 - CPU:多核心处理器(4核以上推荐,8核或更多更佳)(处理200张以上影像建议16GB+)。 - 内存 (RAM):至少 16GB,处理大面积区域建议 32GB 或以上。 - 硬盘空间:预留充足的存储空间。原始影像、中间文件和最终成果会占用大量空间。建议准备 影像大小的10-20倍

By Ne0inhk
Flutter 组件 upnp_client 的鸿蒙适配实战 - 实现跨设备服务发现、智能家居自动关联与多媒体投屏协议控制

Flutter 组件 upnp_client 的鸿蒙适配实战 - 实现跨设备服务发现、智能家居自动关联与多媒体投屏协议控制

欢迎加入开源鸿蒙跨平台社区:https://openharmonycrossplatform.ZEEKLOG.net Flutter 组件 upnp_client 的鸿蒙适配实战 - 实现跨设备服务发现、智能家居自动关联与多媒体投屏协议控制 前言 在“万物互联”的愿景下,鸿蒙系统(OpenHarmony)最核心的武器就是跨设备协同能力。然而,如何让你的 Flutter 应用在复杂的家庭或办公内网中,自动发现并操控那些非鸿蒙生态但同样广泛分布的设备(如:DLNA 智能电视、家用路由器、网络打印机、甚至是 NAS 存储)? UPnP(Universal Plug and Play)协议此时扮演了全局搜索的关键角色。作为一套基于 SSDP 和 HTTP 处理发现与控制的老牌协议,它依然是局域网互联互通的“基础设施”。 upnp_client 为 Flutter

By Ne0inhk