重学SpringBoot3-SPI机制

更多SpringBoot3内容请关注我的专栏：《SpringBoot3》
期待您的点赞👍收藏⭐评论✍

重学SpringBoot3-SPI机制

什么是 SPI？
Spring Boot 中的 SPI 机制
- spring.factories 文件
- 自动配置的实现
- 启动流程中的作用
SPI实际应用
- 步骤 1: 新建模块
- 步骤 2: 创建自动配置类
- 步骤 3: 注册自动配置类
- 步骤 4: 使用
- 步骤 5: 测试
最佳实践与注意事项
- 1. 明确条件注解
- 2. 避免类路径问题
- 3. 使用 `@ConditionalOnMissingBean`
- 4. 文档和示例
- 5. 分离自动配置和业务逻辑
总结

Spring Boot 的核心特性之一是其强大的自动配置功能，它极大地简化了 Spring 应用程序的配置。这种自动配置部分依赖于 Spring Boot 的服务提供者接口（SPI）机制，它允许开发者以模块化和可插拔的方式扩展和定制框架行为。接下来将详细探讨 Spring Boot 3 中的 SPI 机制，并通过示例展示如何实际使用它来实现。

什么是 SPI？

SPI（Service Provider Interface）即服务提供者接口，是一种服务发现机制，允许开发者和框架发现和加载可用的服务实现，而不需要在代码中硬编码具体的实现。这种机制使得软件系统能够更加灵活和可扩展。

在 Java 平台上，SPI 通常是通过 java.util.ServiceLoader 类实现的，但 Spring Boot 对这一概念进行了扩展，以支持其自动配置和模块化架构。

Spring Boot 中的 SPI 机制

Spring Boot 利用 spring.factories （注意：从 SpringBoot 2.7 起自动配置不推荐使用 /META-INF/spring.factories 文件，而是在/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports）文件，位于每个项目根目录的 META-INF/ 目录下，来实现其 SPI 机制。这个文件列出了与自动配置相关的接口及其实现类，Spring Boot 启动时会加载这些配置。

spring.factories 文件

这个文件使用键值对的格式列出了多种服务类型及其对应的实现类，常见的服务类型包括：

org.springframework.boot.autoconfigure.EnableAutoConfiguration：用于自动配置。
org.springframework.context.ApplicationListener：用于应用事件监听器。
org.springframework.boot.autoconfigure.template.TemplateAvailabilityProvider：用于模板引擎的可用性判断。

以下是 spring.factories 文件的一个典型例子：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.example.JpaAutoConfiguration,\
org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration

org.springframework.context.ApplicationListener=\
com.example.MyApplicationListener

Spring Boot 3 则要在 resources/META_INFO/spring/ 目录下新建 org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件，并填入需要自动配置的类的全路径：

com.example.JpaAutoConfiguration

自动配置的实现

在 Spring Boot 中，自动配置类使用 @ConditionalXxx 注解来控制配置类的加载条件。这允许 Spring Boot 根据当前应用的环境，如类路径上的类、环境变量、系统属性等，条件性地应用配置，例如，一个自动配置类可能只在 JPA 实体类存在时才加载：

@Configuration
@ConditionalOnClass(name = "javax.persistence.Entity")
public class JpaAutoConfiguration {
    // 配置 JPA 相关的 beans
}

启动流程中的作用

在 Spring Boot 的启动流程中，当 SpringApplication 类被调用时，它将初始化一个 SpringApplicationContext。在这个过程中，Spring Boot 通过 SpringFactoriesLoader 类来加载 spring.factories 或 org.springframework.boot.autoconfigure.AutoConfiguration.imports 文件中定义的各种组件，包括自动配置类。然后，根据应用的实际环境（比如类路径上的库和定义的 Beans），以及自动配置类上的条件注解，决定是否激活这些自动配置类。

SPI实际应用

让我们通过一个自定义 stater 示例来展示如何创建和使用自定义的自动配置。

步骤 1: 新建模块

自定义的 starter 不需要启动类，需要删掉。

步骤 2: 创建自动配置类

创建一个自动配置类，这个类将提供一个服务，仅在某个特定的类如 SpecificClass 存在于启动类类路径上时才加载 MyService 类型的 bean。

package com.coderjia.spi.config;

import com.coderjia.spi.service.MyService;
import com.coderjia.spi.service.impl.MyServiceImpl;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * @author CoderJia
 * @create 2024/5/5 下午 03:29
 * @Description
 **/

@Configuration
@ConditionalOnClass(name = "com.coderjia.features.config.SpecificClass")
public class MyAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public MyService MyService() {
        return new MyServiceImpl();
    }
}

MyService 类简单实现：

public class MyServiceImpl implements MyService {
    @Override
    public void sayHello() {
        System.out.println("hello");
    }
}

步骤 3: 注册自动配置类

接下来，SpringBoot 2.7 以下在模块的 META-INF/spring.factories 文件中注册这个自动配置类：

org.springframework.boot.autoconfigure.EnableAutoConfiguration=\
com.coderjia.spi.config.MyAutoConfiguration

SpringBoot 2.7 及以上在 /META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports文件中添加自动配置类：

com.coderjia.spi.config.MyAutoConfiguration

这样配置后，只要 SpecificClass 类存在于类路径上，Spring Boot 就会自动配置 MyService。

步骤 4: 使用

在其他项目中，只需 pom 文件中引入我们自定义的 starter 依赖，并确保 SpecificClass 类在类路径上，Spring Boot 将自动应用这个配置。

        <dependency>
            <groupId>com.coderjia</groupId>
            <artifactId>spring-boot3-07-spi</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>