如何自定义一个自己的 Spring Boot Starter 组件（从入门到实践）

文章目录

- - - 一、什么是 Spring Boot Starter？
    - 二、为什么要自定义 Starter？
    - 三、自定义 Starter 的基本步骤
    - - 1. 创建 Maven 项目
      - 2. 配置 `pom.xml`
      - 3. 创建自动配置类
      - 4. 创建业务逻辑类
      - 5. 创建 spring.factories
    - 四、使用自定义 Starter
    - 五、总结
    - 推荐阅读文章

在使用 Spring Boot 开发微服务时，Spring Boot Starter 提供了一种简便的方式来引入各种功能模块。通过 Starter，开发者可以轻松地将所需的依赖和配置封装在一起，简化项目配置。然而，在实际开发中，我们常常需要自定义 Starter，以便满足特定的业务需求。今天，我们就来一起学习如何自定义一个 Spring Boot Starter。

一、什么是 Spring Boot Starter？

Spring Boot Starter 是一组 Maven 依赖的集合，旨在简化 Spring Boot 应用的配置。每个 Starter 通常包括所需的库、自动配置类、属性文件等，使得开发者只需简单地添加一个 Starter，就可以快速启动所需的功能。

例如，spring-boot-starter-web 包含了构建 Web 应用所需的所有依赖，包括 Spring MVC、Jackson 等。

二、为什么要自定义 Starter？

自定义 Starter 主要有以下几个原因：

复用性：将常用的功能封装为 Starter，方便在多个项目中复用。
简化配置：将复杂的配置和依赖管理集中处理，减少每个项目中的重复配置。
团队协作：不同团队可以将各自的功能封装成独立的 Starter，提升项目的模块化程度。

三、自定义 Starter 的基本步骤

接下来，我们将通过创建一个简单的自定义 Starter 来逐步了解其实现过程。我们将创建一个名为 my-spring-boot-starter 的 Starter，它提供一个简单的服务打印消息。

1. 创建 Maven 项目

首先，我们需要创建一个 Maven 项目，命名为 my-spring-boot-starter。项目结构如下：

my-spring-boot-starter
│
├── pom.xml
├── src
│   └── main
│       ├── java
│       │   └── com
│       │       └── example
│       │           └── mystarter
│       │               ├── MyService.java
│       │               └── MyAutoConfiguration.java
│       └── resources
│           └── META-INF
│               └── spring.factories

2. 配置 `pom.xml`

在 pom.xml 中，添加 Spring Boot 的相关依赖和插件配置：

<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.example</groupId><artifactId>my-spring-boot-starter</artifactId><version>1.0.0</version><packaging>jar</packaging><properties><java.version>17</java.version><spring.boot.version>2.7.5</spring.boot.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-autoconfigure</artifactId></dependency></dependencies><build><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId></plugin></plugins></build>
</project>

这里引入了 spring-boot-autoconfigure 依赖，它提供了自动配置所需的功能。

3. 创建自动配置类

在 MyAutoConfiguration.java 中，我们将定义自动配置的逻辑：

package com.example.mystarter;import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
@EnableAutoConfiguration
public class MyAutoConfiguration {@Beanpublic MyService myService() {return new MyService("Hello from MyService!");}
}

这里，我们创建了一个 MyService 的 Bean，并在其中传递了一条消息。

4. 创建业务逻辑类

在 MyService.java 中，我们定义一个简单的服务类，用于打印消息：

package com.example.mystarter;public class MyService {private final String message;public MyService(String message) {this.message = message;}public void printMessage() {System.out.println(message);}
}

5. 创建 spring.factories

为了让 Spring Boot 自动加载我们的配置类，我们需要在 src/main/resources/META-INF/spring.factories 文件中添加如下内容：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.mystarter.MyAutoConfiguration

这告诉 Spring Boot 在启动时要加载我们的自动配置类。

四、使用自定义 Starter

完成自定义 Starter 的开发后，我们可以在其他 Spring Boot 项目中使用它。首先，在需要使用该 Starter 的项目中添加 Maven 依赖：

<dependency><groupId>com.example</groupId><artifactId>my-spring-boot-starter</artifactId><version>1.0.0</version>
</dependency>

接下来，我们可以通过 Spring 上下文获取 MyService 的 Bean，并调用其方法：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class DemoApplication implements CommandLineRunner {@Autowiredprivate MyService myService;public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}@Overridepublic void run(String... args) throws Exception {myService.printMessage();}
}