在学习自定义starter前，需要先了解SpringBoot自动配置原理。学习完SpringBoot自动配置原理以后，我们来自己制作一个starter。
一、自定义starter介绍
在Spring Boot中，starter是一种特殊的依赖，它可以帮助开发人员快速引入和配置某个特定的功能模块。
Spring Boot的官方starter并不一定包含所有开发人员所需的功能，这时候就需要自定义starter来满足特定项目的需求。
自定义starter是一种自包含的、可重用的模块，它封装了一组特定功能的依赖和配置，并提供了简化配置的方式。通过自定义starter，开发人员可以将一些常用的功能封装起来，使得在其他项目中引入这些功能变得更加简单和方便。
二、自定义Starter的好处及优势
特点及优势 |
说明 |
模块化 |
自定义Starter可以将特定的功能模块化，使得开发人员可以更方便地管理和维护代码。 |
简化配置 |
通过自定义Starter，开发人员可以简化配置，减少重复的配置工作，提高开发效率。 |
提高代码重用性 |
自定义Starter可以封装一组特定功能的依赖和配置，使得在其他项目中引入这些功能变得更加简单和方便，从而提高代码重用性。 |
自定义功能 |
如果Spring Boot的官方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工程
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需要的配置操作，再进行一次封装。用户就可以省去配置的过程，做到引入就自动配置。
