一文详解SpringBoot3如何自定义starter

 更新时间:2024年09月08日 11:43:31   作者:蓝染-惣右介  
在Spring Boot中,starter是一种特殊的依赖,它可以帮助开发人员快速引入和配置某个特定的功能模块,我们在面试中通过会被问到SpringBoot3如何自定义starter,所以本文小编给大家详细介绍了SpringBoot3自定义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工程

再创建一个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需要的配置操作,再进行一次封装。用户就可以省去配置的过程,做到引入就自动配置。

以上就是一文详解SpringBoot3如何自定义starter的详细内容,更多关于SpringBoot3自定义starter的资料请关注脚本之家其它相关文章!

相关文章

  • Java数组的扩容代码示例

    Java数组的扩容代码示例

    这篇文章主要介绍了Java数组的扩容,分享了相关代码示例,小编觉得还是挺不错的,具有一定借鉴价值,需要的朋友可以参考下
    2017-09-09
  • java -jar命令详解之运行JAR文件、传递参数与性能调优

    java -jar命令详解之运行JAR文件、传递参数与性能调优

    这篇文章主要介绍了java -jar命令详解之运行JAR文件、传递参数与性能调优的相关资料,java -jar命令用于运行可执行的JAR文件,它解析JAR文件中的META-INF/MANIFEST.MF文件来确定主类,并执行该类的 main方法,运行时可通过参数传递给主类,需要的朋友可以参考下
    2025-04-04
  • SpringIOC控制反转的原理详解

    SpringIOC控制反转的原理详解

    这篇文章主要介绍了SpringIOC控制反转的原理详解,本来管理业务对象(bean)的操作是由我们程序员去做的,但是有了 Spring 核心容器后,这些 Bean 对象的创建和管理交给我们Spring容器去做了,也就是控制权由程序员变成了容器,需要的朋友可以参考下
    2023-08-08
  • SpringBoot自定义线程池,执行定时任务方式

    SpringBoot自定义线程池,执行定时任务方式

    这篇文章主要介绍了SpringBoot自定义线程池,执行定时任务方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-04-04
  • SpringBoot项目中org.junit.jupiter.api.Test报错问题及解决

    SpringBoot项目中org.junit.jupiter.api.Test报错问题及解决

    这篇文章主要介绍了SpringBoot项目中org.junit.jupiter.api.Test报错问题及解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-11-11
  • Spring Boot与Spark、Cassandra系统集成开发示例

    Spring Boot与Spark、Cassandra系统集成开发示例

    本文演示以Spark作为分析引擎,Cassandra作为数据存储,而使用Spring Boot来开发驱动程序的示例。对spring boot 与spark cassandra集成开发示例代码感兴趣的朋友跟着脚本之家小编一起学习吧
    2018-02-02
  • 基于Java的Socket多客户端Client-Server聊天程序的实现

    基于Java的Socket多客户端Client-Server聊天程序的实现

    这篇文章主要介绍了基于Java的Socket多客户端Client-Server聊天程序的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-03-03
  • Java并发编程——volatile关键字

    Java并发编程——volatile关键字

    这篇文章主要介绍了Java并发编程——volatile关键字的相关资料,帮助大家更好的理解和学习Java并发编程,感兴趣的朋友可以了解下
    2020-10-10
  • Java排序算法之归并排序简单实现

    Java排序算法之归并排序简单实现

    这篇文章主要介绍了Java排序算法之归并排序简单实现,具有一定借鉴价值,需要的朋友可以参考下。
    2017-12-12
  • Java8 LocalDateTime时间日期类使用实例详解

    Java8 LocalDateTime时间日期类使用实例详解

    本文从 LocalDateTime 类的创建、转换、格式化与解析、计算与比较以及其他操作几个方面详细介绍了 LocalDateTime 类在 Java 8 中的使用,感兴趣的朋友跟随小编一起看看吧
    2024-03-03

最新评论