SpringBoot：自定义Starter_springboot应用篇(一):自定义starter-优快云博客

本文详细介绍了如何从头开始创建一个自定义的Spring Boot启动器，包括命名规范、模块结构设置、自动配置、属性配置、服务编写、自动配置类实现、配置文件注册以及测试使用。通过这个过程，读者能够理解Spring Boot启动器的工作原理，并学会构建自己的启动器组件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

说明

启动器模块是一个空 jar 文件，仅提供辅助性依赖管理，这些依赖可能用于自动装配或者其他类库；

命名归约：

官方命名：

前缀：spring-boot-starter-xxx
比如：spring-boot-starter-web....

自定义命名：

xxx-spring-boot-starter
比如：mybatis-spring-boot-starter

编写启动器

1、在IDEA中新建一个空项目 spring-boot-starter-diy

2、新建一个普通Maven模块：zjb-spring-boot-starter

3、新建一个Springboot模块：zjb-spring-boot-starter-autoconfigure

4、点击apply即可，基本结构

5、在我们的 starter 中导入 autoconfigure 的依赖！

 <!-- 启动器 -->
    <dependencies>
        <!--  引入自动配置模块 -->
        <dependency>
            <groupId>com.zjb</groupId>
            <artifactId>zjb-spring-boot-starter-autoconfigure</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>

6、将 autoconfigure 项目下多余的文件都删掉，Pom中只留下一个 starter，这是所有的启动器基本配置！

7、我们编写一个自己的服务

package com.zjb.service;

import com.zjb.properties.HelloProperties;

public class HelloService {
    HelloProperties helloProperties;

    public HelloProperties getHelloProperties() {
        return helloProperties;
    }

    public void setHelloProperties(HelloProperties helloProperties) {
        this.helloProperties = helloProperties;
    }

    public String sayHello(String name){
        return helloProperties.getPrefix() + name + helloProperties.getSuffix();
    }
}

8、编写HelloProperties 配置类

package com.zjb.properties;

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

// 前缀 zjb.hello
@ConfigurationProperties(prefix = "zjb.hello")
public class HelloProperties {
    private String prefix;
    private String suffix;

    public String getPrefix() {
        return prefix;
    }

    public void setPrefix(String prefix) {
        this.prefix = prefix;
    }

    public String getSuffix() {
        return suffix;
    }

    public void setSuffix(String suffix) {
        this.suffix = suffix;
    }
}

9、编写我们的自动配置类并注入bean，测试！

package com.zjb.config;

import com.zjb.properties.HelloProperties;
import com.zjb.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.autoconfigure.condition.ConditionalOnWebApplication;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
@ConditionalOnWebApplication //web应用生效
@EnableConfigurationProperties(HelloProperties.class)
public class HelloServiceAutoConfiguration {
    @Autowired
    HelloProperties helloProperties;

    @Bean
    public HelloService helloService(){
        HelloService service = new HelloService();
        service.setHelloProperties(helloProperties);
        return service;
    }

}

10、在resources编写一个自己的 META-INF\spring.factories

# Auto Configure
org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.zjb.config.HelloServiceAutoConfiguration

11、编写完成后，可以安装到maven仓库中！

新建项目测试我们自己写的启动器

1、新建一个SpringBoot 项目

2、导入我们自己写的启动器


<dependency>
    <groupId>com.zjb</groupId>
    <artifactId>zjb-spring-boot-starter</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

3、编写一个 HelloController 进行测试我们自己的写的接口！

package com.example.demo.controller;

import com.zjb.service.HelloService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Autowired
    HelloService helloService;

    @RequestMapping("/hello")
    public String hello(){
        return helloService.sayHello("zxc");
    }
}

4、编写配置文件 application.properties

zjb.hello.prefix="ppp"
zjb.hello.suffix="sss"

5、启动项目进行测试，结果成功 !