详解SpringBoot中自定义starter的开发与使用

更新时间：2023年09月04日 15:13:41 作者：JK凯

starter是SpringBoot中非常重要的一个机制,他是基于约定优于配置的思想所衍生出来的,本文主要介绍了SpringBoot中自定义starter的开发与使用,感兴趣的可以了解下

开发公司业务时，如何去封装公共通用的代码，常见的选择是工具类之类，但是如果我们又需要在其他项目中使用呢？工具类复制一份过去？还有就是定义成单独的模块，也很好，但其实有个更好的选择是使用自定义starter，自定义的starter在使用起来会非常方便，这篇文章主要讲讲如何自定义starter，大家可以基于此去封装公司中的一些公共代码。

介绍 starter

starter是SpringBoot中非常重要的一个机制，他是基于约定优于配置的思想所衍生出来的，摒弃了以前像Spring中需要使用一个依赖，需要添加非常多的配置，starter会在引入依赖时自动扫描需要加载的默认模块及配置，发现我们所定义的Bean并自动注册到IOC容器中。

一、创建 SpringBoot 项目并引入依赖

命名规范

SpringBoot官方的starter命名规范为：spring-boot-starter-{name}
自定义starter命名规范为：{name}-spring-boot-starter

首先通过IDEA创建一个SpringBoot项目。

这里我通过一个简单的日志功能来实现自定义starter功能，创建一个mylog-spring-boot-starter项目。对应的pom文件：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.15</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.jk</groupId>
    <artifactId>mylog-spring-boot-starter</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>mylog-spring-boot-starter</name>
    <description>mylog-spring-boot-starter</description>
    <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.28</version>
        </dependency>
    </dependencies>
</project>

引入的依赖：

spring-boot-autoconfigure：这个依赖是实现自动配置的核心依赖，它会根据定义的META-INF/spring.factories里面定义的类全路径去找到这个类，然后根据@Bean注解所描述的方法注册Bean到IOC容器中。
spring-boot-configuration-processor：这个依赖是为了实现在application.yml中定义配置时的提示功能。
lombok：实现类中自动补全getter、setter、构造器等方法。

二、定义核心的 Service

这个service即在业务项目引入这个starter时可以自动装配的类。

service.MyLogService：

import lombok.Data;
@Data
public class MyLogService {
    private String prefix;
    private String suffix;
    public void print(String log) {
        System.out.println(prefix + " " + log + " " + suffix);
    }
}

定义了一个print方法，实现日志的打印，日志的前缀和后缀我们会在后面的Properties中定义一个默认的，也可以通过在引入这个starter的业务模块中通过配置文件修改。

三、定义 Properties

定义Properties类来实现JavaConfig功能，把application.yml或application.properties中的配置读取映射到Java类上。

config.MyLogProperties：

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;
@Data
@ConfigurationProperties(prefix = "mylog")
public class MyLogProperties {
    private String prefix = "myPrefix";
    private String suffix = "mySuffix";
}

@Data：通过这个lombok的注解实现类的setter、getter、构造器方法的自动补全。
@ConfigurationProperties：通过这个注解实现类与配置文件的绑定和值的注入，通过prefix可以定义在配置文件中的统一前缀。比如配置文件中mylog.prefix的值就会绑定到类中prefix属性上。

四、定义 AutoConfiguration

定义AutoConfiguration类，引入starter时，会自动配置的类，它会自动注册里面的@Bean到spring中IOC容器中。

config.MyLogAutoConfiguration：

import com.jk.mylogspringbootstarter.service.MyLogService;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
@EnableConfigurationProperties(MyLogProperties.class)
public class MyLogAutoConfiguration {
    @Bean
    public MyLogService demoModule(MyLogProperties properties) {
        MyLogService myLogService = new MyLogService();
        myLogService.setPrefix(properties.getPrefix());
        myLogService.setSuffix(properties.getSuffix());
        return myLogService;
    }
}

@Configuration：表明这是SpringBoot中的配置类。
@EnableConfigurationProperties：使我们之前定义的Properties生效。
@Bean：引入starter时自动注册的Bean。

五、定义 spring.factory

在resources中创建META-INF目录并创建spring.factories文件。写入以下内容:

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.jk.mylogspringbootstarter.config.MyLogAutoConfiguration

上面这行内容固定，表示自动配置的类路径，下面需写我们之前定义的AutoConfiguration的全路径。

到此我们自定义starter源代码部分就完成了，整体的代码结构如下：

六、打包 starter，并在项目中测试

在IDEA中通过maven install在进行打包

或者通过在命令行中执行mvn clear install来进行打包，打包后会把这个依赖包安装到我们本地maven仓库。

在业务项目中:

1. pom中引入对应的starter

<dependency>
    <groupId>com.jk</groupId>
    <artifactId>mylog-spring-boot-starter</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

2. 自动装配在starter中定义的MyLogService

3. 日志打印结果

可以看到日志的前缀和后缀为之前我们在Properties中定义的默认值。

4. 修改日志前缀、后缀配置

通过在业务项目中application.yml修改前缀和后缀

测试打印结果如下：

到此这篇关于详解SpringBoot中自定义starter的开发与使用的文章就介绍到这了,更多相关SpringBoot自定义starter内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java重点之基于比较的七大排序
最近几天在研究排序算法，看了很多博客，发现网上有的文章中对排序算法解释的并不是很透彻，而且有很多代码都是错误的，所以我根据这几天看的文章，整理了一个较为完整的排序算法总结，本文中的所有算法均有JAVA实现，经本人调试无误后才发出，如有错误，请各位前辈指出
2021-10-10
oracle数据库导入TXT文件方法介绍
这篇文章主要介绍了oracle数据库导入TXT文件方法介绍，文中向大家展示了具体代码示例，需要的朋友可以参考下。
2017-09-09
Java用BigDecimal类解决Double类型精度丢失的问题
这篇文章主要介绍了Java用BigDecimal类解决Double类型精度丢失的问题，帮助大家更好的理解和使用Java，感兴趣的朋友可以了解下
2020-12-12
JavaScript中HTML元素操作的实现
本文主要介绍了JavaScript中HTML元素操作的实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2023-06-06
Java中的自动装箱与自动拆箱的实现
自动装箱和自动拆箱使得我们在使用基本数据类型时更加方便,同时也提高了代码的可读性和健壮性,本文将详细介绍Java中的自动装箱和自动拆箱机制,感兴趣的可以了解一下
2023-08-08
Java实现学生管理系统(IO版)
这篇文章主要为大家详细介绍了Java实现学生管理系统，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-02-02
SpringMVC的工程搭建步骤实现
这篇文章主要介绍了SpringMVC的工程搭建步骤实现，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2021-04-04
Java常用锁synchronized和ReentrantLock的区别
这篇文章主要介绍了Java常用锁synchronized和ReentrantLock的区别，二者的功效都是相同的，但又有很多不同点，下面我们就进入文章了解具体的相关内容吧。需要的小伙伴也可以参考一下
2022-05-05
Java同步非阻塞模式NIO处理IO数据
这篇文章主要介绍了Java同步非阻塞模式NIO处理IO数据,服务器实现模式为一个请求一个线程,即客户端发送的链接请求都会注册到选择器上,选择器轮询到连接有IO请求时才启动一个线程进行处理,需要的朋友可以参考下
2023-10-10
Spring @DateTimeFormat日期格式化时注解场景分析
这篇文章主要介绍了Spring @DateTimeFormat日期格式化时注解场景分析,本文通过实例代码给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
2023-05-05