自定义 Spring Boot Starter 启动器

2024-05-25 22:32
文章标签 java 自定义 spring boot 启动器 starter

本文主要是介绍自定义 Spring Boot Starter 启动器，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

前言

    SpringBoot摒弃了以前Spring繁杂的配置（xml），在使用 SpringBoot 时可以很方便的引入各种官方提供的starter（如：spring-boot-starter-web、spring-boot-starter-thymeleaf等），仅需少量的配置，SpringBoot 就能够自动扫描到要加载的信息并启动相应的默认配置，做到了开箱即用、减少大量的配置项、约定优于配置。

    而在日常开发中，某些场景下我们还会引入一些自己封装、复用性高、独立强的模块，但是每次引入都要为其大量配置。那么问题来了，要如何将这些模块封装成独立的开箱即用starter呢？

就跟着下面的样例代码（相关源码）一起看看吧。

自定义启动器

创建 starter 工程

创建一个spring boot 工程，pom.xml如下所示：

<?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.2.0.RELEASE</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.huitian</groupId><artifactId>huitian-spring-boot-starter</artifactId><version>1.0.0-SNAPSHOT</version><name>huitian-spring-boot-starter</name><description>Spring Boot Starter 封装样例</description><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><java.version>1.8</java.version><maven.test.skip>true</maven.test.skip></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><!--移除Tomcat依赖--><exclusions><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId></exclusion></exclusions></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-undertow</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure</artifactId></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure-processor</artifactId></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency></dependencies></project>

注意：必须引入spring-boot-autoconfigure与spring-boot-autoconfigure-processor来加载配置。

编写 自定义 Trigger

该启动器以定时任务功能演示业务逻辑。

package com.huitian.spring.boot.starter.trigger;import org.springframework.scheduling.Trigger;
import org.springframework.scheduling.TriggerContext;
import org.springframework.scheduling.support.CronTrigger;import java.util.Date;public class TaskTrigger implements Trigger {/*** cron 表达式*/private String cron;public TaskTrigger(String cron) {this.cron = cron;}@Overridepublic Date nextExecutionTime(TriggerContext triggerContext) {return new CronTrigger(cron).nextExecutionTime(triggerContext);}
}

编写 Propertie

用于读取配置文件的信息。

package com.huitian.spring.boot.starter.properties;import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;@Data
@ConfigurationProperties(prefix = "huitian.starter")
public class HuitianStarterPropertie {/*** 任务名称*/private String taskName;/*** 任务触发 Cron 表达式*/private String taskCron;}

编写启动器的 Config

此处为注册定时任务，特实现SchedulingConfigurer接口的configureTasks方法。

package com.huitian.spring.boot.starter.config;import com.huitian.spring.boot.starter.properties.HuitianStarterPropertie;
import com.huitian.spring.boot.starter.trigger.TaskTrigger;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.EnableScheduling;
import org.springframework.scheduling.annotation.SchedulingConfigurer;
import org.springframework.scheduling.config.ScheduledTaskRegistrar;@Slf4j
@Configuration
@EnableScheduling
@EnableConfigurationProperties(HuitianStarterPropertie.class)
public class HuitianStarterConfig implements SchedulingConfigurer {@Autowiredprivate HuitianStarterPropertie huitianStarterPropertie;@Overridepublic void configureTasks(ScheduledTaskRegistrar taskRegistrar) {// 注册定时任务taskRegistrar.addTriggerTask(() -> {// 定时任务方法...log.info("执行定时任务: [{}]", huitianStarterPropertie.getTaskName());}, new TaskTrigger(huitianStarterPropertie.getTaskCron()));}
}

编写 Controller

此处编写的Controller是为了将接口集成到引入启动器的项目中。

package com.huitian.spring.boot.starter.controller;import com.huitian.spring.boot.starter.properties.HuitianStarterPropertie;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class HuitianController {@Autowiredprivate HuitianStarterPropertie huitianStarterPropertie;@GetMapping("/task")public String hello() {return "正在调度 [" + huitianStarterPropertie.getTaskName() + "] 任务.";}}

编写 spring.factories

SpringApplication在构造方法中，会扫描引入启动器的src/main/resources/META-INF目录下的spring.factories文件，来加载配置类。

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.huitian.spring.boot.starter.config.HuitianStarterConfig

编写 spring-configuration-metadata.json （可选）

{"groups": [{"name": "huitian","type": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie","description": "启动器配置","sourceType": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie"},{"name": "huitian.starter","type": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie","description": "启动器配置","sourceType": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie"}],"properties": [{"name": "huitian.starter.taskName","type": "java.lang.String","description": "任务名称","sourceType": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie","defaultValue": ""},{"name": "huitian.starter.taskCron","type": "java.lang.String","description": "任务触发 Cron 表达式","sourceType": "com.huitian.spring.boot.starter.properties.HuitianStarterPropertie","defaultValue": ""}],"hints": []
}

编写好该文件，会在配置application配置文件的时候带有提示。
在这里插入图片描述
至此，启动器编写完成！
为方便其他工程引入，还需要通过maven将启动器工程安装（install）或部署（deploy）到仓库中。

测试

创建 test 工程

创建一个spring boot 工程，pom.xml如下所示：

<?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.2.0.RELEASE</version><relativePath/> <!-- lookup parent from repository --></parent><groupId>com.huitian</groupId><artifactId>huitian-spring-boot-starter-test</artifactId><version>1.0.0-SNAPSHOT</version><name>huitian-spring-boot-starter-test</name><description>Spring Boot Starter 封装样例测试</description><properties><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><java.version>1.8</java.version><maven.test.skip>true</maven.test.skip></properties><dependencies><!-- 引入自定义的启动器 --><dependency><groupId>com.huitian</groupId><artifactId>huitian-spring-boot-starter</artifactId><version>1.0.0-SNAPSHOT</version></dependency></dependencies></project>

编写 application.yml 配置文件

server:servlet:context-path: /huitianport: 8080huitian:starter:taskName: "测试任务01"# 每秒一次taskCron: "* * * * * *"

启动 test 工程

直接启动HuitianSpringBootStarterTestApplication#main()

  • 启动器已按配置执行了定时任务，控制台日志如下：
Connected to the target VM, address: '127.0.0.1:6375', transport: 'socket'
2021-02-04 16:27:22.428  INFO 7896 --- [           main] .HuitianSpringBootStarterTestApplication : Starting HuitianSpringBootStarterTestApplication on MSI with PID 7896 (E:\Workspase-damo\huitian-spring-boot-starter-demo\huitian-spring-boot-starter-test\target\classes started by Onovo in E:\Workspase-damo\huitian-spring-boot-starter-demo\huitian-spring-boot-starter-test)
2021-02-04 16:27:22.432  INFO 7896 --- [           main] .HuitianSpringBootStarterTestApplication : No active profile set, falling back to default profiles: default
2021-02-04 16:27:23.261  WARN 7896 --- [           main] io.undertow.websockets.jsr               : UT026010: Buffer pool was not set on WebSocketDeploymentInfo, the default pool will be used
2021-02-04 16:27:23.288  INFO 7896 --- [           main] io.undertow.servlet                      : Initializing Spring embedded WebApplicationContext
2021-02-04 16:27:23.288  INFO 7896 --- [           main] o.s.web.context.ContextLoader            : Root WebApplicationContext: initialization completed in 792 ms
2021-02-04 16:27:23.450  INFO 7896 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Initializing ExecutorService 'applicationTaskExecutor'
2021-02-04 16:27:23.589  INFO 7896 --- [           main] s.a.ScheduledAnnotationBeanPostProcessor : No TaskScheduler/ScheduledExecutorService bean found for scheduled processing
2021-02-04 16:27:23.604  INFO 7896 --- [           main] io.undertow                              : starting server: Undertow - 2.0.27.Final
2021-02-04 16:27:23.609  INFO 7896 --- [           main] org.xnio                                 : XNIO version 3.3.8.Final
2021-02-04 16:27:23.620  INFO 7896 --- [           main] org.xnio.nio                             : XNIO NIO Implementation Version 3.3.8.Final
2021-02-04 16:27:23.674  INFO 7896 --- [           main] o.s.b.w.e.u.UndertowServletWebServer     : Undertow started on port(s) 8080 (http) with context path '/huitian'
2021-02-04 16:27:23.677  INFO 7896 --- [           main] .HuitianSpringBootStarterTestApplication : Started HuitianSpringBootStarterTestApplication in 1.732 seconds (JVM running for 2.749)
2021-02-04 16:27:24.007  INFO 7896 --- [pool-1-thread-1] c.h.s.b.s.config.HuitianStarterConfig    : 执行定时任务: [测试任务01]
2021-02-04 16:27:25.004  INFO 7896 --- [pool-1-thread-1] c.h.s.b.s.config.HuitianStarterConfig    : 执行定时任务: [测试任务01]
2021-02-04 16:27:26.013  INFO 7896 --- [pool-1-thread-1] c.h.s.b.s.config.HuitianStarterConfig    : 执行定时任务: [测试任务01]
2021-02-04 16:27:27.005  INFO 7896 --- [pool-1-thread-1] c.h.s.b.s.config.HuitianStarterConfig    : 执行定时任务: [测试任务01]
  • 访问启动器内的Controller：http://127.0.0.1:8080/huitian/task
    在这里插入图片描述
    至此，测试完成。

原理

    这里就需要聊聊SpringBoot的启动方式。

对于本项目启动

    SpringBoot 启动类默认的@SpringBootApplication注解中默认包含了@EnableAutoConfiguration注解，启动时就能扫描本项目下被@Configuration注解修饰的类并将其注入IOC容器。

对于引入的 starter 启动

    而对于引入的starter项目来说，@Configuration不能在本项目中扫描到，是无法加载的。所以需要启动时读取/META-INF/spring.factories文件，然后读取org.springframework.boot.autoconfigure.EnableAutoConfiguration指向的由@Configuration注解修饰的类并将其注入IOC容器。

如：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.huitian.spring.boot.starter.config.HuitianStarterConfig

让我们来一起看看源码：

1. new SpringApplication(XxxApplication.class);
2. getSpringFactoriesInstances();
3. SpringFactoriesLoader.loadFactoryNames();
4. loadSpringFactories();

在这里插入图片描述

    SpringBoot 的这种配置加载方式是一种类似于 SPI 的方式，SPI可以在META-INF/services配置接口扩展的实现类，SpringBoot中原理类似，只是名称换成了spring.factories而已。

starter 命名规则

Spring 官方命名规则
  • 前缀：spring-boot-starter-{name}
  • 模式：spring-boot-starter-模块名
  • 举例：spring-boot-starter-web、spring-boot-starter-thymeleaf
自定义命名规则
  • 后缀：{name}-spring-boot-starter
  • 模式：模块-spring-boot-starter
  • 举例：mybatis-spring-boot-starter

这篇关于自定义 Spring Boot Starter 启动器的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1002797。

相关文章

Java中流式并行操作parallelStream的原理和使用方法

Java中流式并行操作parallelStream的原理和使用方法

《Java中流式并行操作parallelStream的原理和使用方法》本文详细介绍了Java中的并行流（parallelStream）的原理、正确使用方法以及在实际业务中的应用案例,并指出在使用并行流... 目录Java中流式并行操作parallelStream0. 问题的产生1. 什么是parallelS
阅读更多...
Java中Redisson 的原理深度解析

Java中Redisson 的原理深度解析

《Java中Redisson的原理深度解析》Redisson是一个高性能的Redis客户端,它通过将Redis数据结构映射为Java对象和分布式对象,实现了在Java应用中方便地使用Redis,本文... 目录前言一、核心设计理念二、核心架构与通信层1. 基于 Netty 的异步非阻塞通信2. 编解码器三、
阅读更多...
SpringBoot基于注解实现数据库字段回填的完整方案

SpringBoot基于注解实现数据库字段回填的完整方案

《SpringBoot基于注解实现数据库字段回填的完整方案》这篇文章主要为大家详细介绍了SpringBoot如何基于注解实现数据库字段回填的相关方法,文中的示例代码讲解详细,感兴趣的小伙伴可以了解... 目录数据库表pom.XMLRelationFieldRelationFieldMapping基础的一些代
阅读更多...
一篇文章彻底搞懂macOS如何决定java环境

一篇文章彻底搞懂macOS如何决定java环境

《一篇文章彻底搞懂macOS如何决定java环境》MacOS作为一个功能强大的操作系统,为开发者提供了丰富的开发工具和框架,下面：本文主要介绍macOS如何决定java环境的相关资料,文中通过代码... 目录方法一：使用 which命令方法二：使用 Java_home工具（Apple 官方推荐）那问题来了，
阅读更多...
Java HashMap的底层实现原理深度解析

Java HashMap的底层实现原理深度解析

《JavaHashMap的底层实现原理深度解析》HashMap基于数组+链表+红黑树结构,通过哈希算法和扩容机制优化性能,负载因子与树化阈值平衡效率,是Java开发必备的高效数据结构,本文给大家介绍... 目录一、概述：HashMap的宏观结构二、核心数据结构解析1. 数组（桶数组）2. 链表节点（Node
阅读更多...
Java AOP面向切面编程的概念和实现方式

Java AOP面向切面编程的概念和实现方式

《JavaAOP面向切面编程的概念和实现方式》AOP是面向切面编程,通过动态代理将横切关注点（如日志、事务）与核心业务逻辑分离,提升代码复用性和可维护性,本文给大家介绍JavaAOP面向切面编程的概... 目录一、AOP 是什么？二、AOP 的核心概念与实现方式核心概念实现方式三、Spring AOP 的关
阅读更多...
详解SpringBoot+Ehcache使用示例

详解SpringBoot+Ehcache使用示例

《详解SpringBoot+Ehcache使用示例》本文介绍了SpringBoot中配置Ehcache、自定义get/set方式,并实际使用缓存的过程,文中通过示例代码介绍的非常详细,对大家的学习或者... 目录摘要概念内存与磁盘持久化存储：配置灵活性：编码示例引入依赖：配置ehcache.XML文件：配置
阅读更多...
Java 虚拟线程的创建与使用深度解析

Java 虚拟线程的创建与使用深度解析

《Java虚拟线程的创建与使用深度解析》虚拟线程是Java19中以预览特性形式引入,Java21起正式发布的轻量级线程,本文给大家介绍Java虚拟线程的创建与使用,感兴趣的朋友一起看看吧... 目录一、虚拟线程简介1.1 什么是虚拟线程？1.2 为什么需要虚拟线程？二、虚拟线程与平台线程对比代码对比示例：三
阅读更多...
Java中的.close()举例详解

Java中的.close()举例详解

《Java中的.close()举例详解》.close()方法只适用于通过window.open()打开的弹出窗口,对于浏览器的主窗口,如果没有得到用户允许是不能关闭的,：本文主要介绍Java中的.... 目录当你遇到以下三种情况时，一定要记得使用 .close()：用法作用举例如何判断代码中的 input
阅读更多...
Spring Gateway动态路由实现方案

Spring Gateway动态路由实现方案

《SpringGateway动态路由实现方案》本文主要介绍了SpringGateway动态路由实现方案,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随... 目录前沿何为路由RouteDefinitionRouteLocator工作流程动态路由实现尾巴前沿S
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2