嘿，哥们儿！日常搬砖时，是不是经常在pom.xml里熟练地敲下这样的代码：
<dependency>
<groupId>com.mybatis-flex</groupId>
<artifactId>mybatis-flex-spring-boot3-starter</artifactId>
<version>1.10.9</version>
</dependency>
<dependency>
<groupId>com.github.xingfudeshi</groupId>
<artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
<version>4.6.0</version>
</dependency>
然后，神奇的事情发生了——MyBatis的Mapper接口能直接注入了，Knife4j的API文档界面自动就绪了。你有没有那么一瞬间，挠着头问自己：“这玩意儿...到底是怎么工作的？”
如果你和我一样，对技术背后的“为什么”充满好奇，渴望成为团队里那个能解决棘手问题的大佬，那么，恭喜你，来对地方了。
一、Starter到底是个啥？它不是“银弹”，是“套餐”
1.我们要颠覆一个认知：starter本身可能一行Java代码都没有。
它本质上是一个**“套餐”，一个精心搭配好的Maven依赖集合。它的核心使命，就是为了实现Spring Boot的终极哲学——“约定优于配置”（Convention over Configuration）**。
当你引入一个starter时，你实际上引入了两样东西：
-
必要的依赖库：比如
mybatis-starter会帮你把mybatis、mybatis-spring、jdbc-api等一大堆jar包都下载好，省去了你手动管理版本兼容性的烦恼。 -
一个自动配置文件：这才是魔法的核心！这个配置文件会告诉你的Spring Boot应用：“嘿，我这里有个新功能，在满足某些条件时，请自动把它配置好，加载到Spring容器里。”
二、魔法核心：自动装配（Auto-Configuration）的运行三部曲
Spring Boot的自动装配过程，就像一场精密的舞台剧，一切都围绕着@EnableAutoConfiguration这个注解展开。
整个过程可以总结为三步：
-
启动与扫描：
@EnableAutoConfiguration开启了自动装配的大门。Spring Boot会去扫描所有依赖jar包里的特定文件——对于Spring Boot 3来说，就是META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports。 -
加载配置类：从这个
imports文件里，Spring Boot能拿到一个长长的“自动配置候选人”列表。 -
条件化装配：这是最精髓的一步！Spring Boot会挨个审视这些“候选人”，通过
@ConditionalOnClass（当classpath下有某个类时）、@ConditionalOnProperty（当配置文件里有某个属性时）、@ConditionalOnMissingBean（当容器里没有某个Bean时）等一系列“条件注解”来判断，到底要不要让这个“候选人”转正。
这种“按需加载、智能判断”的机制，既保证了功能的强大，又避免了不必要的资源浪费和配置冲突。
三、实战：打造一个自己的helloworld-starter
现在就来创建一个自己的starter。
我们的目标是：创建一个HelloWorldService，它有一个sayHello方法。这个方法输出的问候语，可以通过我们项目的application.yml文件来定制。
1. 项目结构
一个标准的starter通常包含两个模块，这是一个最佳实践：
-
helloworld-spring-boot-autoconfigure：这是核心模块，包含了所有自动配置的Java代码和逻辑。 -
helloworld-spring-boot-starter：这是一个“空壳”模块，它不做任何具体实现，只负责一件事——通过Maven依赖，把autoconfigure模块和其它必要的库（比如spring-boot-starter）打包在一起，方便最终用户引入。
2. 编写autoconfigure模块
这是我们的主战场。
a. 定义配置属性类 HelloWorldProperties.java
这个类用来接收application.yml中的配置。
// HelloWorldProperties.java
package com.example.helloworld.autoconfigure;
import org.springframework.boot.context.properties.ConfigurationProperties;
@ConfigurationProperties(prefix = "hello.world") // 绑定配置文件中前缀为hello.world的属性
public class HelloWorldProperties {
/**
* Whether to enable the hello world service. Defaults to true.
*/
private boolean enabled = true;
/**
* The name to be displayed in the greeting.
*/
private String name = "World";
// Getters and Setters...
public boolean isEnabled() {
return enabled;
}
public void setEnabled(boolean enabled) {
this.enabled = enabled;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
b. 编写核心服务 HelloWorldService.java
这个服务很简单，就是根据配置的name来打个招呼。
// HelloWorldService.java
package com.example.helloworld.autoconfigure;
public class HelloWorldService {
private final HelloWorldProperties properties;
public HelloWorldService(HelloWorldProperties properties) {
this.properties = properties;
}
public String sayHello() {
return "Hello, " + properties.getName() + "!";
}
}
c. 编写自动配置类 HelloWorldAutoConfiguration.java
这是整个starter的灵魂！
// HelloWorldAutoConfiguration.java
package com.example.helloworld.autoconfigure;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration // 声明这是一个配置类
@EnableConfigurationProperties(HelloWorldProperties.class) // 启用我们刚才定义的属性类
@ConditionalOnProperty(prefix = "hello.world", name = "enabled", havingValue = "true", matchIfMissing = true) // 当hello.world.enabled=true时，或没有这个配置时，此配置类才生效
public class HelloWorldAutoConfiguration {
private final HelloWorldProperties properties;
public HelloWorldAutoConfiguration(HelloWorldProperties properties) {
this.properties = properties;
}
@Bean // 往Spring容器里注册一个Bean
public HelloWorldService helloWorldService() {
return new HelloWorldService(properties);
}
}
d. 创建imports文件
在src/main/resources/META-INF/spring/目录下，创建一个名为org.springframework.boot.autoconfigure.AutoConfiguration.imports的文件，内容只有一行，就是我们自动配置类的全路径名：
com.example.helloworld.autoconfigure.HelloWorldAutoConfiguration
这就是给Spring Boot自动装配机制引路的“地图”。
3. 配置starter模块
这个模块非常简单，它的pom.xml只需要依赖autoconfigure模块即可：
<dependencies>
<dependency>
<groupId>com.example</groupId>
<artifactId>helloworld-spring-boot-autoconfigure</artifactId>
<version>${project.version}</version>
</dependency>
</dependencies>
好了，大功告成！现在把这个项目mvn install到你的本地仓库。
4. 使用我们自己的Starter
现在，新建一个全新的Spring Boot项目，来体验一下自己的劳动成果。
a. 引入依赖
在pom.xml中，像引用任何其他starter一样，引入我们的starter：
注意这里你开发的starter， 可能还需要发布到mvn 仓库才能向下面引用。
<dependency>
<groupId>com.example</groupId>
<artifactId>helloworld-spring-boot-starter</artifactId>
<version>0.0.1-SNAPSHOT</version>
</dependency>
b. 修改配置
在application.yml中，我们可以定制我们的服务：
hello:
world:
name: "老铁"
c. 测试
在你的Spring Boot应用中，直接注入并使用HelloWorldService：
package com.example.demo;
import com.example.helloworld.autoconfigure.HelloWorldService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
@SpringBootApplication
public class DemoApplication implements CommandLineRunner {
@Autowired
private HelloWorldService helloWorldService;
public static void main(String[] args) {
SpringApplication.run(DemoApplication.class, args);
}
@Override
public void run(String... args) throws Exception {
System.out.println(helloWorldService.sayHello());
}
}
运行DemoApplication，你将在控制台看到那句亲切的问候：
Hello, 老铁!
如果你在application.yml中把enabled设为false，再次运行，程序会报错，提示找不到HelloWorldService这个Bean。这证明我们的@ConditionalOnProperty完美地工作了！
结论：
现在，回头再看那些官方或第三方的starter，是不是感觉它们的“底裤”都被你看穿了？
万变不离其宗，所有starter的核心都是**“依赖管理 + 条件化自动装配”**。
从今天起，别再只当一个starter的使用者了。动手试试，你也能成为创造“魔法”的那个工程师。
扫一扫
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
