Java 面试宝典：如何自定义一个starter？

回答

在 Spring Boot 中定义一个 starter 主要包括如下几个步骤：

创建一个项目：创建一个独立的 Maven 或者 Gradle 项目，作为 Starter 的基本框架，并添加 spring-boot-autoconfigure 依赖
编写自动配置类：编写一个自动配置类，这个类通过 @Configuration 注解来封装你要自动装配的 Bean。
配置 spring.factories 文件：在 src/main/resources/META-INF 目录下创建 spring.factories 文件，声明需要自动装配的配置类。关于是使用 spring.factories 还是 spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports，参考面试题：为什么SpringBoot 3中移除了spring.factories
发布 starter：将自定义 Starter 构建成 JAR 包，并发布到 Maven 仓库，其他项目直接用用即可。

详解

starter 的实现原理

自定义 starter 的案例网上有很多，大明哥就不演示了，这里重点讲 start 的实现原理。

自定义 starter 的核心原理在于自动配置机制和条件话装配：

自动配置机制：Spring Boot 通过 @EnableAutoConfiguration 和 spring.factories 文件，自动配置应用需要的 Bean 和功能。参考面试题：Spring Boot是如何实现自动配置的？
条件化话装配：使用 @ConditionalOnClass、@ConditionalOnProperty 等注解，根据环境或配置条件，决定是否加载和装配某些功能。参考面试题：@Conditional注解有什么用

这里以 mybatis-plus-boot-starter 为例。

我们找对应的配置文件：

Spring Boot 在启动的时候会去扫描应用中的spring.factories 或者 spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件内容，加载里面生命的自动配置类，并根据条件装配相对应的 Bean。文件内容如下：

com.baomidou.mybatisplus.autoconfigure.IdentifierGeneratorAutoConfiguration
com.baomidou.mybatisplus.autoconfigure.MybatisPlusLanguageDriverAutoConfiguration
com.baomidou.mybatisplus.autoconfigure.MybatisPlusAutoConfiguration

IdentifierGeneratorAutoConfiguration

IdentifierGeneratorAutoConfiguration 是 MyBatis-plus 中用于自动配置标识符生成器的类，它的主要作用是自动为 MyBatis-Plus 配置一个 ID 生成器，通常用于数据库表的主键生成策略：

@Lazy
@ConditionalOnClass(InetUtils.class)
@ConditionalOnBean(InetUtils.class)
@Configuration(proxyBeanMethods = false)
public class IdentifierGeneratorAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public IdentifierGenerator identifierGenerator(InetUtils inetUtils) {
        return new DefaultIdentifierGenerator(inetUtils.findFirstNonLoopbackAddress());
    }
}

@Lazy：表明 IdentifierGeneratorAutoConfiguration 的加载是懒加载，并不随 Spring 容器启动就立刻加载，而是等到用的时候才会被加载。在有些时候我们可能确实是不需要 MyBatis-plus 的 id 生成器。
@ConditionalOnClass(InetUtils.class) 和 @ConditionalOnBean(InetUtils.class)，表明 IdentifierGeneratorAutoConfiguration 需要当前类路径下存在 InetUtils 这个 Bean 才会被加载。
@Configuration(proxyBeanMethods = false)：表明 Spring 不能为 IdentifierGeneratorAutoConfiguration 创建代理对象。

当容器中不存在 IdentifierGenerator 对应的 bean 时就会执行 identifierGenerator() 创建 IdentifierGenerator Bean 并完成注册：

    @Bean
    @ConditionalOnMissingBean
    public IdentifierGenerator identifierGenerator(InetUtils inetUtils) {
        return new DefaultIdentifierGenerator(inetUtils.findFirstNonLoopbackAddress());
    }

InetUtils 是 Spring 中的一个工具类，用于提供与网络相关的操作，其 findFirstNonLoopbackAddress() 会返回第一个非回环地址（即非 127.0.0.1），该地址被传递给 DefaultIdentifierGenerator 的构造函数用来初始化 ID 生成器：

    public DefaultIdentifierGenerator(InetAddress inetAddress) {
        this.sequence = new Sequence(inetAddress);
    }

Sequence 是 MyBatis-plus 中的数据库序列，他是一种用于生成唯一标识的机制。DefaultIdentifierGenerator 是 MyBatis-plus 中默认的 id 生成器器，内部通过调用 Sequence 的 nextId() 来生成唯一 id。

MybatisPlusLanguageDriverAutoConfiguration

MybatisPlusLanguageDriverAutoConfiguration 是 MyBatis-Plus 的核心组件，主要用于配置和启用 MyBatis-Plus 的 SQL 自定义语法解析器（也叫做语言驱动）。

在 MyBatis-Plus 中，语言驱动负责解析特定的 SQL 语法，尤其是对 MyBatis-Plus 扩展的一些功能（如乐观锁、自动分页等），它提供了更高效的 SQL 生成和处理能力。定义如下：

@Lazy
@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(LanguageDriver.class)
public class MybatisPlusLanguageDriverAutoConfiguration {
  //...
}

LanguageDriver 是 MyBatis 中的核心接口，它负责将 SQL 语句映射到 MyBatis 的执行引擎。在 MyBatis 中，SQL 语句不仅仅是数据库的操作指令，还可能包含动态 SQL、参数映射等。LanguageDriver 就是负责将这些 SQL 转换为 MyBatis 可执行的语句的组件。它主要执行如下任务：

将 XML 中的 SQL 语句、注解中定义的 SQL 语句以及 MyBatis 动态 SQL 标签（如 <if>、<choose> 等）转换为 MyBatis 可以处理的 SQL 语句。
支持自定义 SQL 语法扩展。MyBatis 允许通过自定义 LanguageDriver 来处理一些特殊的 SQL 语法或数据库特性，MyBatis Plus 就通过扩展 LanguageDriver 来支持分页、乐观锁等功能。

而 MybatisPlusLanguageDriverAutoConfiguration 则就是负责初始化和配置 MyBatis-Plus 的 LanguageDriver，从而使 MyBatis 能够处理 MyBatis Plus 提供的增强功能。MybatisPlusLanguageDriverAutoConfiguration 会将 MyBatis Plus 的 LanguageDriver 配置到 MyBatis 的上下文中，从而允许 MyBatis 使用 MyBatis-Plus 提供的特殊 SQL 解析功能。

MybatisPlusAutoConfiguration 就不介绍了，有兴趣的小伙伴可以自己去研究下！

Java 面试宝典是大明哥全力打造的 Java 精品面试题，它是一份靠谱、强大、详细、经典的 Java 后端面试宝典。它不仅仅只是一道道面试题，而是一套完整的 Java 知识体系，一套你 Java 知识点的扫盲贴。

它的内容包括：

大厂真题：Java 面试宝典里面的题目都是最近几年的高频的大厂面试真题。
原创内容：Java 面试宝典内容全部都是大明哥原创，内容全面且通俗易懂，回答部分可以直接作为面试回答内容。
持续更新：一次购买，永久有效。大明哥会持续更新 3+ 年，累计更新 1000+，宝典会不断迭代更新，保证最新、最全面。
覆盖全面：本宝典累计更新 1000+，从 Java 入门到 Java 架构的高频面试题，实现 360° 全覆盖。
不止面试：内容包含面试题解析、内容详解、知识扩展，它不仅仅只是一份面试题，更是一套完整的 Java 知识体系。
宝典详情：https://www.yuque.com/chenssy/sike-java/xvlo920axlp7sf4k
宝典总览：https://www.yuque.com/chenssy/sike-java/yogsehzntzgp4ly1
宝典进展：https://www.yuque.com/chenssy/sike-java/en9ned7loo47z5aw

目前 Java 面试宝典累计更新 400+ 道，总字数 42w+。大明哥还在持续更新中，下图是大明哥在 2024-12 月份的更新情况：

想了解详情的小伙伴，扫描下面二维码加大明哥微信【daming091】咨询

同时，大明哥也整理一套目前市面最常见的热点面试题。微信搜[大明哥聊 Java]或扫描下方二维码关注大明哥的原创公众号[大明哥聊 Java] ，回复【面试题】即可免费领取。

阅读全文