14.2 手写过 starter,14.1 拆过自动装配,这一节把镜头拉到最外层:SpringApplication.run() 那一分钟里发生了什么——用手写 mini-springboot 复盘,三十行核心代码讲清 Spring Boot 的三板斧:内嵌容器、自动装配、条件装配。手写完你会发现 Spring Boot 没有魔法,只是把 Servlet 容器搬进 JVM、把配置搬运自动化。
public static void run(Class configClass) {
// 1. 创建容器(注解驱动的Web容器)
AnnotationConfigWebApplicationContext ctx =
new AnnotationConfigWebApplicationContext();
ctx.register(configClass);
ctx.refresh(); // 2. 触发扫描/装配/Bean初始化
// 3. 从容器里找 WebServer 实现并启动
WebServer webServer = getWebServer(ctx);
webServer.start();
}
private static WebServer getWebServer(WebApplicationContext ctx) {
Map<String, WebServer> beans =
ctx.getBeansOfType(WebServer.class);
if (beans.isEmpty()) throw new NullPointerException();
if (beans.size() > 1) throw new IllegalStateException();
return beans.values().stream().findFirst().get();
}
主线三步:建容器、refresh、起容器。精髓在第三步的接口抽象——WebServer 是接口,TomcatWebServer 与 JettyWebServer 各自实现(内部各自 new Tomcat / new Server 并配端口),run 方法只认接口不认实现,从容器里 getBeansOfType 挑出唯一实现启动。换服务器=换一个 Bean,run 方法零改动——14.1 讲的「Spring Boot 内嵌 Tomcat 可替换」落到代码就这么朴素。size 大于 1 抛异常的细节也对齐真实行为:类路径同时有 Tomcat 与 Jetty 依赖时 Spring Boot 启动报错要求二选一,手写版用最直白的方式复现了这条报错。
手写版的配置类上是一个组合注解 @ZhouyuSpringBootApplication = @ComponentScan + @ZhouyuEnableAutoConfiguration,后者又 @Import(ZhouyuImportSelector.class)。ImportSelector 的 selectImports 返回配置类全限定名数组,容器据此加载自动配置类——「注解上的注解+Import 展开成类清单」就是自动装配的全部机关。真实 Spring Boot 的差异只在清单的来源:手写版硬编码返回 WebServerAutoConfiguration.class,Spring Boot 从所有 jar 的 META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件聚合(14.1 的 2.7+ 机制)——把硬编码换成「扫配置文件」,手写版就向真品靠近了一大步,14.2 手写 starter 时吃过同一个螃蟹。
@ZhouyuConditionalOnClass("org.apache.catalina.startup.Tomcat")
@Bean public WebServer tomcatWebServer() { return new TomcatWebServer(); }
WebServerAutoConfiguration 里两个 Bean 方法各挂一个条件注解:类路径有 Tomcat 就注册 TomcatWebServer,有 Jetty 就注册 JettyWebServer。条件注解的元注解是 @Conditional(OnClassCondition.class),容器在注册每个 Bean 前回调 Condition 的 matches 方法,返回 false 直接跳过——条件装配=注册前的 if 语句。手写时用 Class.forName(类名) 探测类路径,try-catch 包住 ClassNotFoundException 返回 false,二十行写完一个 OnClassCondition。14.1 列过的条件家族(OnBean/OnProperty/OnMissingBean)全同一套路:实现 Condition 接口,从上下文取数做判断。自定义 starter 的开关项(@ConditionalOnProperty(prefix="xxx.log", name="enabled", havingValue="true"))到这里彻底祛魅:就是个读环境变量的 if。
完整跑通还差两件事。其一,端口配置:TomcatWebServer 里 tomcat.setPort(8080) 写死,进阶改法是从 Environment 读 server.port——配置的外部化(14.3)在 mini 版里只值五行代码。其二,DispatcherServlet 注册:Web 容器起来后要把 DispatcherServlet 挂进 ServletContext(ctx.addServlet("dispatcher", new DispatcherServlet(webApplicationContext)).addMapping("/")),这样 HTTP 请求才能流进 Spring MVC 的十五件套(15.1)——Spring Boot 的「一键起服务」,终点是把 15 章的 MVC 流水线装进 19.2 说的内嵌容器,三章知识在 run 方法里会师。
手写版在 refresh 之后从容器里捞 WebServer 启动,真实 Spring Boot 的 WebServer 却是在 refresh 之内创建的——ServletWebServerApplicationContext 覆写了 onRefresh 回调,在里面实例化 Tomcat、绑定端口,然后 publishEvent 广播容器就绪。差异不是绕弯子,是被一个死结逼出来的:DispatcherServlet 是个 Bean,它初始化时需要 ServletContext;而 ServletContext 要 Tomcat 先起来才有。先 refresh 再起容器,Bean 初始化时拿不到 ServletContext;先起容器再 refresh,容器里又还没有 DispatcherServlet 可挂。Spring Boot 的解法是把 WebServer 的创建塞进 refresh 中段的 onRefresh(此时容器已具备 BeanFactory 但 Bean 未实例化),等 refresh 末段 DispatcherServlet 初始化时 ServletContext 已就位——回调时机就是解依赖环的钥匙,这个细节面试讲出来,比背十二步名单高一个段位。
真实 SpringApplication 在 run 之前还有一段构造逻辑值得对齐:构造器里推断应用类型(类路径有 Servlet 相关类是 SERVLET、有 WebFlux 没有 Servlet 是 REACTIVE、都没有是 NONE),推断类型决定后面创建哪种 ApplicationContext——手写版直接写死 Web 容器,等于跳过了这道选择题。run 启动时还有一条事件线:SpringApplicationRunListeners 广播 ApplicationStartingEvent、EnvironmentReadyEvent、ContextRefreshedEvent、ApplicationReadyEvent,监听器体系(19.3 的事件机制在启动期的应用)贯穿始终——启动过程的每一步都对外广播,第三方组件靠挂监听器接入启动周期而不改主流程,这又是开闭原则的一次落地。手写版全无事件,功能不缺,但「想插入自定义逻辑时无处下手」的别扭,恰好让你体会到事件线的价值。
复盘自动装配就不能不谈它的代价:Spring Boot 2.2 起提供 spring.main.lazy-initialization=true,全局懒加载把 Bean 的创建从启动期推迟到第一次使用,启动时间立减(代价是首次请求变慢、启动期不再暴露装配错误——@Lazy 的老账,13.2 讲过)。另一个手段是 AOT:Spring Boot 3 的 GraalVM 原生镜像把反射、代理、条件判断在构建期全部算死,启动从秒级压到几十毫秒——自动装配本质是「运行期反射做决策」,AOT 是「构建期把决策固化成代码」,手写过 ImportSelector 与 Condition 之后再看 AOT,就能准确说出它固化的是什么:你手写的那二十行 matches 逻辑,AOT 替你在构建期跑完了。手写版的两处硬编码(容器类型与端口写死),就是它离真品最近的作业清单。
mini-springboot 三十行 run 方法揭穿底牌:Spring Boot=Spring 容器+Import 展开的自动装配+Condition 开关+接口化的内嵌容器——魔法拆完都是熟悉的面孔,手写的意义就是让你在面试里敢说「启动流程我写过」。