serviceloader通过spi机制在运行时自动发现并加载实现类,核心做法是调用 serviceloader.load() 并传入接口与类加载器,随后使用 iterator() 遍历获取实例。该过程依赖 meta-inf/services/ 目录下的配置文件,配置文件中每行写一个具体实现类的完整限定名。若配置文件中存在重复类或类路径冲突,会抛出异常或导致加载失败。

如何定义和配置 SPI 接口及实现类
首先需要创建一个接口作为服务提供者契约,然后在资源目录下创建以接口全名为文件名的配置文件,并在其中列出所有实现类的全名。这样 ServiceLoader 才能知道要加载哪些类。

package com.example;
public interface MyService {
void execute();
}
// 实现类
package com.example.impl;
import com.example.MyService;
public class DefaultService implements MyService {
@Override
public void execute() {
System.out.println("Default service executed");
}
}
预期结果:编译后,在 src/main/resources/META-INF/services/com.example.MyService 文件中写入 com.example.impl.DefaultService。运行程序时,ServiceLoader 能正确找到该类。
立即学习“Java免费学习笔记(深入)”;
如何在代码中加载并使用服务实例
在业务代码中,通过 ServiceLoader.load(MyService.class) 获取加载器实例,然后调用 iterator() 进行遍历。通常使用 findFirst() 获取第一个实例,或使用循环处理多个实例。如果未找到任何实现,迭代器将为空。

import java.util.ServiceLoader;
public class Main {
public static void main(String[] args) {
ServiceLoader<MyService> loader = ServiceLoader.load(MyService.class);
for (MyService service : loader) {
service.execute();
}
}
}
预期结果:控制台输出 "Default service executed"。如果配置文件中没有指定任何类,则不会有任何输出。
当配置文件中包含多个实现类时会发生什么
当配置文件中包含多个实现类时,ServiceLoader 会按照文件中声明的顺序依次加载并实例化这些类。每个类都会被实例化一次,除非该类实现了 java.lang.AutoCloseable 且在使用完毕后需要关闭。如果某个类无法实例化(例如缺少构造函数或依赖缺失),则会抛出 ServiceConfigurationError 并中断后续加载。


















