最新版 | SpringBoot3如何自定义starter（面试常考）

在学习自定义starter前，需要先了解SpringBoot自动配置原理。学习完SpringBoot自动配置原理以后，我们来自己制作一个starter。

一、自定义starter介绍

在Spring Boot中，starter是一种特殊的依赖，它可以帮助开发人员快速引入和配置某个特定的功能模块。

Spring Boot的官方starter并不一定包含所有开发人员所需的功能，这时候就需要自定义starter来满足特定项目的需求。

自定义starter是一种自包含的、可重用的模块，它封装了一组特定功能的依赖和配置，并提供了简化配置的方式。通过自定义starter，开发人员可以将一些常用的功能封装起来，使得在其他项目中引入这些功能变得更加简单和方便。

二、自定义Starter的好处及优势

三、自定义starter应用场景

在我们的日常开发工作中，可能会需要开发一个通用模块，以供其它工程复用。SpringBoot就为我们提供这样的功能机制，我们可以把我们的通用模块封装成一个个starter，这样其它工程复用的时候只需要在pom中引用依赖即可，由SpringBoot为我们完成自动装配。

• 常见的应用场景：

1）通用模块-短信发送模块

2）基于AOP技术实现日志切面

3）分布式雪花ID，Long转String，解决精度问题

4）微服务项目的数据库连接池配置

5）微服务项目的每个模块都要访问redis数据库，每个模块都要配置redisTemplate

四、自定义starter

我们可以先参考一下MyBatis的starter，一般情况下起步依赖会由两个工程组成，一个是xxx-autoconfigure提供自动配置功能，另一个是xxx-starter提供依赖管理功能。同时会在starter中引入autoconfigure，将来使用者引入starter就可以了。

了解了自定义starter的套路后，我们来自定义一个MyBatis的starter。

1、创建autoconfigure的maven工程

创建一个maven工程，名字叫做dmybatis-spring-boot-autoconfigure，前面加d是为了和MyBatis官方的起步依赖区分开。

注意命名规范：springboot官方提供的starter一般以spring-boot-starter-xxxx方式命名，官方建议自定义的starter使用xxxx-spring-boot-starter命名。用来区分第三方的starter和springboot官方的starter。

2、创建starter的maven工程

再创建一个maven工程，名字叫做dmybatis-spring-boot-starter。

3、在autoconfigure的pom文件中引入MyBatis的所需依赖

首先我们观察一下MyBatis的官方起步依赖包含哪些子依赖：

• org.springframework.boot:spring-boot-starter:3.3.3
• org.springframework.boot:spring-boot-starter-jdbc:3.3.3
• org.mybatis.spring.boot:mybatis-spring-boot-autoconfigure:3.0.3
• org.mybatis:mybatis:3.5.14
• org.mybatis:mybatis-spring:3.0.3

其中org.mybatis.spring.boot:mybatis-spring-boot-autoconfigure:3.0.3依赖我们不需要引入，因为autoconfigure模块由我们自定义。只需在autoconfigure的pom文件中引入其他的依赖：

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <version>3.3.3</version>
  </dependency>

  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-jdbc</artifactId>
    <version>3.3.3</version>
  </dependency>

  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.14</version>
  </dependency>

  <dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis-spring</artifactId>
    <version>3.0.3</version>
  </dependency>
</dependencies>

4、编写自动配置类MyBatisAutoConfiguration

@AutoConfiguration  // 表识当前类是一个自动配置类
public class MyBatisAutoConfiguration {
    // SqlSessionFactoryBean
    @Bean
    public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource) {
        SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
        sqlSessionFactoryBean.setDataSource(dataSource);
        return sqlSessionFactoryBean;
    }

    // MapperScannerConfigurer
    @Bean
    public MapperScannerConfigurer mapperScannerConfigurer(BeanFactory beanFactory) {
        MapperScannerConfigurer mapperScannerConfigurer = new MapperScannerConfigurer();
        // 扫描的包：启动类所在的包及其子包
        List<String> packages = AutoConfigurationPackages.get(beanFactory); // 获取启动类所在的包名
        String basePackage = packages.get(0);   // 因为启动类所在的包只有一个，直接获取第一个
        mapperScannerConfigurer.setBasePackage(basePackage);    // 设置mapper的包扫描路径
        // 扫描的注解：@Mapper
        mapperScannerConfigurer.setAnnotationClass(Mapper.class);
        return mapperScannerConfigurer;
    }
}

5、编写imports配置文件

在autoconfigure项目的/resources/META-INF/spring目录下创建org.springframework.boot.autoconfigure.AutoConfiguration.imports配置文件，注意存放路径要严格遵循这个文件夹名和文件名，SpringBoot才会识别到配置文件。

在imports文件中，我们只需要填写MyBatis的自动配置类的全类名即可：

com.aizen.config.MyBatisAutoConfiguration

6、在starter的pom文件中引入autoconfigure的文件

<dependencies>
  <dependency>
    <groupId>com.aizen</groupId>
    <artifactId>dmybatis-spring-boot-autoconfigure</artifactId>
    <version>1.0-SNAPSHOT</version>
  </dependency>
</dependencies>

7、测试自定义starter是否生效

在springboot-mybatis项目中，已经配置了datasource数据源，并写好了后端数据访问接口。

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mybatis
    username: root
    password: root

@Mapper
public interface UserMapper {
    @Select("select * from user where id = #{id}")
    User findById(Integer id);
}

在项目的pom文件中引入自定义MyBatis的starter依赖：

<!-- 自定义的mybatis起步依赖 -->
<dependency>
    <groupId>com.aizen</groupId>
    <artifactId>dmybatis-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

<!--mysql驱动依赖-->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
</dependency>

通过postman测试请求接口，成功查询到数据，说明自定义starter已经生效！

从提供的MyBatis自定义starter结构可以看出，starter就是一个普通的maven项目，引入了需要配置的模块后，帮用户写好接入Spring需要的配置操作，再进行一次封装。用户就可以省去配置的过程，做到引入就自动配置。