Spring Boot 提供了一个基于 Spring 的框架，用于简化基于 Spring 的应用程序开发。Spring Boot 启动器（Starter）是一个带有预先配置的依赖项的 Maven 模块，提供了一种便捷的方式来添加 Spring 功能。本文将详细介绍如何手写一个自定义的 Spring Boot 启动器，包括各个步骤和代码示例。

一、什么是 Spring Boot 启动器？

Spring Boot 启动器是一个 Maven 模块，其中包含一组相关的库和配置，用于简化应用程序的开发。例如，spring-boot-starter-web 包含了构建 Web 应用程序所需的所有依赖项。

二、为什么需要自定义启动器？

自定义启动器允许你创建适合你特定需求的模块化和可重用的组件。它有助于：

减少配置重复
提高开发效率
保持项目结构的一致性

三、创建自定义 Spring Boot 启动器的步骤

创建 Maven 项目
定义 pom 文件
编写自动配置类
创建 META-INF/spring.factories 文件
发布和使用启动器

四、详细步骤及代码示例

1. 创建 Maven 项目

首先，使用 IDE（如 IntelliJ IDEA 或 Eclipse）创建一个新的 Maven 项目。设定 Group ID 和 Artifact ID，例如：

Group ID: com.example
Artifact ID: my-spring-boot-starter

2. 定义 POM 文件

在项目的根目录中找到 pom.xml 文件，并添加必要的依赖项和插件：

<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>0.0.1-SNAPSHOT</version> <packaging>jar</packaging> <name>My Spring Boot Starter</name> <description>Custom spring Boot Starter</description> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.0</version> <relativePath/> </parent> <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>

3. 编写自动配置类

在 src/main/java 目录下创建一个包 com.example.autoconfig，然后创建一个自动配置类：

package com.example.autoconfig;import org.springframework.context.annotation.Bean;import org.springframework.context.annotation.Configuration;import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;@Configurationpublic class MyAutoConfiguration { @Bean @ConditionalOnMissingBean public MyService myService() { return new MyService(); }}

这里，@ConditionalOnMissingBean 注解确保只有在没有定义其他同类型的 Bean 时才会创建这个 Bean。

4. 创建 META-INF/spring.factories 文件

在 src/main/resources 目录下创建 META-INF 文件夹，然后在其中创建 spring.factories 文件，并添加以下内容：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.example.autoconfig.MyAutoConfiguration

这个文件指示 Spring Boot 在启动时加载我们的自动配置类。

5. 发布和使用启动器

构建项目后，发布到你的 Maven 仓库（本地或远程）。在其他项目中，你可以像使用任何其他依赖一样使用它：

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

在应用程序中，你可以注入并使用 MyService：

import com.example.autoconfig.MyService;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.web.bind.annotation.GetMapping;import org.springframework.web.bind.annotation.RestController;@RestControllerpublic class MyController { @Autowired private MyService myService; @GetMapping("/hello") public String sayHello() { return myService.sayHello(); }}

五、总结

通过本文，我们学习了如何创建一个自定义的Spring Boot启动器。自定义启动器可以极大地简化项目的开发过程，使代码更为简洁和模块化。在实际项目中，合理利用自定义启动器可以提升开发效率和代码质量。

Spring Boot 启动器开发指南（spring boot启动器有哪些）