如何应用 module-info.java 中的服务发现机制实战替代传统的 SPI 变量配置文件-java教程-PHP中文网

Java 9模块系统用module-info.java的uses/provides替代META-INF/services，实现编译期类型安全的服务契约声明；服务方需public无参构造，双方必须严格匹配全限定名且正确requires接口模块。

java 9 引入的模块系统（jpms）对传统 spi 机制做了实质性升级：不再依赖 meta-inf/services/xxx 手动配置文件，而是通过 module-info.java 中的 uses / provides 指令，在编译期声明服务契约，由 jvm 在运行时自动完成类型安全的服务发现与绑定。这种替代不是简单“换写法”，而是从字符串驱动转向模块化、可验证、可裁剪的服务治理方式。

module-info.java 中服务声明的规范写法

服务使用方和提供方需在各自模块中明确声明角色，JVM 会据此建立强类型关联：

服务使用者模块（如客户端）必须用 uses 声明它要消费的服务接口

module com.example.client {
    requires com.example.api;
    uses com.example.api.GreetingService; // 告诉 JVM：我要用这个接口
}

服务提供者模块（如国密实现）必须用 provides ... with ... 声明具体实现类

module com.example.sm4impl {
    requires com.example.api;
    provides com.example.api.GreetingService
        with com.example.sm4.SM4GreetingServiceImpl; // 实现类必须是 public & 无参构造
}

注意：provides 后的实现类必须满足两个硬性条件——类是 public 的，且有 public 无参构造器；否则模块加载失败或 ServiceLoader 返回空迭代器。

如何让 ServiceLoader 正常工作在模块化环境

模块化下 ServiceLoader.load() 行为不变，但底层依赖模块图解析而非 classpath 扫描。因此必须确保：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

接口定义模块（如 com.example.api）被双方共同 requires，且该模块不包含 provides 或 uses（仅作契约容器）
消费端模块的 uses 和提供端模块的 provides 必须严格匹配全限定名（大小写、包路径、类名缺一不可）
若使用 --limit-modules 或 jlink 构建最小运行镜像，需显式包含所有参与服务发现的模块（含 java.base）

常见失效情形举例：

提供方模块未 requires 接口模块 → 编译报错 package not visible
消费方漏写 uses → ServiceLoader.load(...).iterator() 返回空，无任何异常提示
实现类位于非默认包或含嵌套结构 → ServiceLoader 无法实例化，抛 ServiceConfigurationError

与传统 META-INF/services 的关键差异点

维度	传统 SPI（classpath）	JPMS 模块化 SPI
配置位置	`META-INF/services/com.example.api.GreetingService`（纯文本，内容为实现类全名）	`module-info.java` 中 `uses`/`provides`（Java 语法，编译期校验）
类型安全	无。拼写错误、类不存在、无参构造缺失均到运行时报错	有。编译阶段即检查接口是否存在、实现类是否可访问、构造器是否合规
模块可见性	所有 jar 下同名文件都会被扫描，易冲突或重复加载	仅模块图中显式 `provides` 的模块参与，无隐式加载，避免污染
服务筛选	无法按模块来源过滤，`ServiceLoader` 返回全部可用实现	可结合 `ModuleLayer` 自定义层策略，实现灰度、多租户等高级路由