自定义 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。

相关文章

JVM 的类初始化机制

JVM 的类初始化机制

前言 当你在 Java 程序中new对象时，有没有考虑过 JVM 是如何把静态的字节码（byte code）转化为运行时对象的呢，这个问题看似简单，但清楚的同学相信也不会太多，这篇文章首先介绍 JVM 类初始化的机制，然后给出几个易出错的实例来分析，帮助大家更好理解这个知识点。 JVM 将字节码转化为运行时对象分为三个阶段，分别是：loading 、Linking、initialization
阅读更多...
Spring Security 基于表达式的权限控制

Spring Security 基于表达式的权限控制

前言 spring security 3.0已经可以使用spring el表达式来控制授权，允许在表达式中使用复杂的布尔逻辑来控制访问的权限。 常见的表达式 Spring Security可用表达式对象的基类是SecurityExpressionRoot。 表达式描述hasRole([role])用户拥有制定的角色时返回true （Spring security默认会带有ROLE_前缀）,去
阅读更多...
浅析Spring Security认证过程

浅析Spring Security认证过程

类图 为了方便理解Spring Security认证流程，特意画了如下的类图，包含相关的核心认证类 概述 核心验证器 AuthenticationManager 该对象提供了认证方法的入口，接收一个Authentiaton对象作为参数; public interface AuthenticationManager {Authentication authenticate(Authenti
阅读更多...
Spring Security--Architecture Overview

Spring Security--Architecture Overview

1 核心组件 这一节主要介绍一些在Spring Security中常见且核心的Java类，它们之间的依赖，构建起了整个框架。想要理解整个架构，最起码得对这些类眼熟。 1.1 SecurityContextHolder SecurityContextHolder用于存储安全上下文（security context）的信息。当前操作的用户是谁，该用户是否已经被认证，他拥有哪些角色权限…这些都被保
阅读更多...
Spring Security基于数据库验证流程详解

Spring Security基于数据库验证流程详解

Spring Security 校验流程图 相关解释说明（认真看哦） AbstractAuthenticationProcessingFilter 抽象类 /*** 调用 #requiresAuthentication(HttpServletRequest, HttpServletResponse) 决定是否需要进行验证操作。* 如果需要验证，则会调用 #attemptAuthentica
阅读更多...
Spring Security 从入门到进阶系列教程

Spring Security 从入门到进阶系列教程

Spring Security 入门系列 《保护 Web 应用的安全》 《Spring-Security-入门（一）：登录与退出》 《Spring-Security-入门（二）：基于数据库验证》 《Spring-Security-入门（三）：密码加密》 《Spring-Security-入门（四）：自定义-Filter》 《Spring-Security-入门（五）：在 Sprin
阅读更多...
Java架构师知识体认识

Java架构师知识体认识

源码分析 常用设计模式 Proxy代理模式Factory工厂模式Singleton单例模式Delegate委派模式Strategy策略模式Prototype原型模式Template模板模式 Spring5 beans 接口实例化代理Bean操作 Context Ioc容器设计原理及高级特性Aop设计原理Factorybean与Beanfactory Transaction 声明式事物
阅读更多...
【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【前端学习】AntV G6-08 深入图形与图形分组、自定义节点、节点动画（下）

【课程链接】 AntV G6：深入图形与图形分组、自定义节点、节点动画（下）_哔哩哔哩_bilibili 本章十吾老师讲解了一个复杂的自定义节点中，应该怎样去计算和绘制图形，如何给一个图形制作不间断的动画，以及在鼠标事件之后产生动画。（有点难，需要好好理解） <!DOCTYPE html><html><head><meta charset="UTF-8"><title>06
阅读更多...
Java进阶13讲__第12讲_1/2

Java进阶13讲__第12讲_1/2

多线程、线程池 1.  线程概念 1.1  什么是线程 1.2  线程的好处 2.   创建线程的三种方式 注意事项 2.1  继承Thread类 2.1.1 认识  2.1.2  编码实现  package cn.hdc.oop10.Thread;import org.slf4j.Logger;import org.slf4j.LoggerFactory
阅读更多...
JAVA智听未来一站式有声阅读平台听书系统小程序源码

JAVA智听未来一站式有声阅读平台听书系统小程序源码

智听未来，一站式有声阅读平台听书系统 🌟&nbsp;开篇：遇见未来，从“智听”开始 在这个快节奏的时代，你是否渴望在忙碌的间隙，找到一片属于自己的宁静角落？是否梦想着能随时随地，沉浸在知识的海洋，或是故事的奇幻世界里？今天，就让我带你一起探索“智听未来”——这一站式有声阅读平台听书系统，它正悄悄改变着我们的阅读方式，让未来触手可及！ 📚&nbsp;第一站：海量资源，应有尽有 走进“智听
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2