第2章 ServiceLoader核心原理

ServiceLoader是Java SPI机制的核心实现类，它封装了服务发现的全部逻辑。理解ServiceLoader如何在运行时定位、加载和实例化服务提供者，是掌握模块边界设计的基础。本章从类加载层次、延迟迭代机制和META-INF/services约定三个维度，逐步拆解ServiceLoader的内部运行原理。

2.1 类加载层次：三层加载器协作

ServiceLoader在加载服务提供者类时，依赖Java的类加载器双亲委派模型。标准的类加载层次包含三个层次：启动类加载器（Bootstrap ClassLoader）、扩展类加载器（Extension ClassLoader）和应用程序类加载器（Application ClassLoader）。ServiceLoader使用传入的类加载器（默认为调用者的上下文类加载器）来加载配置文件和服务实现类。

类加载器在查找资源时，会遵循双亲委派顺序：先让父加载器尝试加载，如果父加载器无法找到资源，再由当前加载器自己查找。这一机制保证了SPI配置文件的可见性边界——同一个类加载器空间内的服务提供者才能被正确发现。

2.2 延迟迭代：按需加载与实例化

ServiceLoader并不是一次性加载所有服务实现，而是采用延迟迭代（Lazy Iteration）模式。当调用iterator()或stream()方法时，ServiceLoader返回一个轻量级的迭代器对象，该迭代器在每次next()调用时才真正解析配置文件并加载对应的实现类。

迭代过程分为两步：

1. 配置解析：读取META-INF/services/文件中以换行符分隔的全限定类名，按行解析为字符串列表。
2. 延迟加载：在调用next()时，使用Class.forName()加载类，并通过newInstance()（Java 9+采用constructor.newInstance()）创建实例。每个实例只创建一次，缓存到内部集合中。

// ServiceLoader延迟加载的核心逻辑简化示意
public class ServiceLoader<S> implements Iterable<S> {
    // 缓存的提供者实例
    private LinkedHashMap<String,S> providers = new LinkedHashMap<>();
    // 延迟查找的迭代器
    private LazyIterator lookupIterator;

    public Iterator<S> iterator() {
        return new Iterator<S>() {
            public boolean hasNext() {
                // 先检查缓存，再触发配置读取
                if (knownProviders.hasNext()) return true;
                return lookupIterator.hasNext();
            }
            public S next() {
                if (knownProviders.hasNext())
                    return knownProviders.next().getValue();
                // 实际加载类并创建实例
                return lookupIterator.next();
            }
        };
    }
}

2.3 META-INF/services约定：服务描述文件

META-INF/services是Java SPI约定的事实标准。每个服务接口对应一个文本文件，文件名是服务接口的全限定名，文件内容是该接口所有实现类的全限定名（每行一个）。ServiceLoader通过这个文件找到服务实现，无需硬编码或外部配置中心。

文件存放位置和命名规则如下表：

# 文件路径示例
# META-INF/services/com.example.spi.CacheProvider
# 内容如下：
com.example.cache.RedisCache
com.example.cache.LocalCache
# com.example.cache.MemcachedCache  (此行被注释，不会加载)

2.4 核心流程：从配置到实例

ServiceLoader从配置到返回服务实例的完整流程可以概括为五个步骤，下图展示了这一过程的结构化视图：

2.5 ServiceLoader API 速查

ServiceLoader在JDK中的核心API如下，开发中主要使用到这些方法：

2.6 调试技巧：验证ServiceLoader加载

在开发过程中，可以通过以下两种方式验证ServiceLoader是否成功加载了服务提供者：

• 打印配置路径：设置JVM参数 -Djava.ext.dirs=... 或使用 System.out.println(System.getProperty("java.class.path")) 检查类路径是否包含目标JAR。
• 遍历所有服务：使用 forEach 打印服务实例，确认加载到的实现类。

// 调试代码：验证ServiceLoader加载结果
ServiceLoader<CacheProvider> loader = ServiceLoader.load(CacheProvider.class);
loader.forEach(provider -> {
    System.out.println("Loaded: " + provider.getClass().getName());
    // 确认无参构造器正常工作
    System.out.println("Provider: " + provider.provideCache().getClass().getName());
});

// 如果输出为空，检查META-INF/services/文件是否存在且正确