SpringBoot自定义starter

一、前言

Spring Boot Starter 是一组预定义的依赖项集合,它们可以帮助开发者快速集成各种功能模块。这些 Starter 可以减少开发者的配置工作,使得开发者可以更加专注于业务逻辑的实现。

举例说明:例如引入MyBatis-Plus的stater,只需要在配置文件中配置即可使用

二、实现步骤

2.1 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 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.qiangesoft.demo</groupId>
    <artifactId>qiangesoft-demo-starter</artifactId>
    <version>1.0.0</version>
    <packaging>jar</packaging>

    <name>${project.artifactId}</name>
    <description>自定义starter</description>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <spring-boot.version>2.7.17</spring-boot.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring-boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-autoconfigure</artifactId>
            <optional>true</optional>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-configuration-processor</artifactId>
            <optional>true</optional>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
            <optional>true</optional>
        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

2.2 属性类

java 复制代码
package com.qiangesoft.demo.starter.config;

import lombok.Data;
import org.springframework.boot.context.properties.ConfigurationProperties;

/**
 * 属性类
 *
 * @author qiangesoft
 * @date 2024-04-29
 */
@Data
@ConfigurationProperties(prefix = "demo")
public class DemoProperties {

    /**
     * 是否启用
     */
    private boolean enabled = true;

    /**
     * 地址
     */
    private String url;

    /**
     * 用户名
     */
    private String username;

    /**
     * 密码
     */
    private String password;

}

2.3 配置类

java 复制代码
package com.qiangesoft.demo.starter.config;

import com.qiangesoft.demo.starter.client.DemoTemplate;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;

/**
 * 配置类
 *
 * @author qiangesoft
 * @date 2024-04-29
 */
@AutoConfiguration
@EnableConfigurationProperties(DemoProperties.class)
@ConditionalOnClass(DemoTemplate.class)
@ConditionalOnProperty(prefix = "demo", name = "enabled", havingValue = "true")
public class DemoConfiguration {

    @Autowired
    private DemoProperties demoProperties;

    @Bean
    @ConditionalOnMissingBean
    public DemoTemplate demoTemplate() {
        return new DemoTemplate(demoProperties.getUrl(),
                demoProperties.getUsername(),
                demoProperties.getPassword());
    }

}

2.4 客户端调用类

java 复制代码
package com.qiangesoft.demo.starter.client;

import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.InitializingBean;

/**
 * api服务
 *
 * @author qiangesoft
 * @date 2024-04-29
 */
@Slf4j
public class DemoTemplate implements InitializingBean {

    /**
     * 地址
     */
    private final String url;

    /**
     * 用户名
     */
    private final String username;

    /**
     * 密码
     */
    private final String password;

    public DemoTemplate(String url, String username, String password) {
        this.url = url;
        this.username = username;
        this.password = password;
        log.info("DemoTemplate init with url[{}], username[{}] !", this.url, this.username);
    }

    @Override
    public void afterPropertiesSet() throws Exception {
        log.info("DemoTemplate init finished !");
    }

    public void execute() {
        log.info("DemoTemplate.execute() executed !");
    }
}

2.5 自动装配

创建spring.factories文件

java 复制代码
org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.qiangesoft.demo.starter.config.DemoConfiguration

三、测试

3.1 注意事项

项目搭建完成后,编译打包安装

重要: 如果打包后没有自动生成spring-configuration-metadata.json文件,是没有自动提示的。需要配置idea的Annotation Processors开启,然后再打包!


3.2 测试使用

引入依赖

xml 复制代码
<dependency>
    <groupId>com.qiangesoft.demo</groupId>
    <artifactId>qiangesoft-demo-starter</artifactId>
    <version>1.0.0</version>
</dependency>

配置

yaml 复制代码
demo:
  enabled: true
  url: 111
  username: 111
  password: 111

api使用

java 复制代码
@Autowired
private DemoTemplate demoTemplate;

@GetMapping
public void test(){
    demoTemplate.execute();
}

测试

相关推荐
锋行天下6 分钟前
LangGraph 对接 MCP 实战指南:从本地开发到线上部署与模型防坑
前端·人工智能·后端
利威尔xu22 分钟前
2026-11-18-Go接口幂等设计实战
开发语言·后端·golang
喵个咪1 小时前
RushWind Admin — update_mask 写面:字段级白名单、显式清除与点路径合并
后端·rust
喵个咪1 小时前
RushWind Admin — 多租户行级隔离与租户回收站:Viewer 三态、repo_shell! 与全域级联清除
后端·rust
喵个咪1 小时前
RushWind CMS — 三服务拓扑:core 领域层、双 BFF 薄代理与一份契约的双面输出
后端·rust
天多高_风不晓得2 小时前
Comparable 与 Comparator
后端
程序员鱼皮2 小时前
这 3 年 AI Agent 到底进化了啥?万字大白话,一次讲透!
前端·后端·aigc
一条Go2 小时前
SSH 命令审核流:为什么「能执行」必须先「被批准」
后端·架构·github
__underline__2 小时前
冷门Python知识点007篇:list[int]不是类,为什么能当基类?
后端·python
用户615218329962 小时前
为什么 String 是不可变的?看懂字符串常量池和底层实现
后端