单纯靠module-info.java无法实现服务变量的动态插拔,因其仅支持编译期和启动期的静态模块声明与服务契约定义,而动态启用/停用/替换需依赖运行时机制如服务注册中心、事件驱动或spring动态bean注册。
单纯靠 module-info.java 无法实现服务变量的“动态插拔”。
module-info 的定位是静态模块声明,不是运行时插件容器
Java Platform Module System(JPMS)的设计目标是编译期和启动期的强封装与依赖治理,而非运行时热加载。它通过 module-info.java 明确声明:
- requires:该模块依赖哪些其他模块(强制性、不可绕过)
- exports:向谁暴露哪些包(可限定到具体模块)
-
uses / provides:声明使用的服务接口,或提供对应的服务实现(用于
ServiceLoader)
注意:uses/provides 是为 java.util.ServiceLoader 服务发现机制准备的——它在类路径或模块路径扫描时静态注册,一旦 JVM 启动完成,ServiceLoader.load() 返回的服务实例列表就已确定,不支持运行时增删服务实现。
真正实现“动态插拔”的关键不在 module-info,而在运行时机制
要达成服务变量(如支付策略、日志适配器、属性计算引擎)的动态启用/停用/替换,需结合以下能力:
-
服务注册中心:例如自建轻量注册表(ConcurrentMap
),配合版本号或状态标记,支持运行时 put/remove -
事件驱动通信:模块通过发布/订阅事件解耦,插件监听特定事件(如
PluginEnabledEvent),自主激活逻辑 -
OSGi Bundle 生命周期:利用
Bundle.start()/stop()触发服务注册与注销,底层由ServiceRegistry管理服务引用 -
Spring 动态 Bean 注册:通过
ConfigurableListableBeanFactory.registerSingleton()或BeanDefinitionRegistry.registerBeanDefinition()在运行时注入/覆盖 Bean
此时 module-info 的作用退居二线:仅确保各插件模块能被正确解析、隔离加载,并安全导出其服务接口(如 exports com.example.plugin.api;),避免包冲突。它不参与“插拔”动作本身。
一个可行的实战组合方案(JPMS + ServiceLoader + 运行时管理器)
若坚持使用 JPMS 基础设施,可按如下方式分层协作:
- 定义共享服务接口模块(
plugin-api),含module-info.java:module plugin.api { exports plugin.api.service; } - 各插件模块(
alipay-plugin,wechat-plugin)在module-info.java中声明:module alipay.plugin { requires plugin.api; provides plugin.api.service.PaymentService with com.alipay.AlipayServiceImpl; } - 主程序不直接调用
ServiceLoader.load(),而是封装一个 PluginManager: 它在启动时用ServiceLoader扫描所有可用实现并缓存; 提供enable(String id)/disable(String id)方法,内部维护一个线程安全的启用状态映射; 所有业务代码通过PluginManager.getActivePaymentService()获取当前生效实例。
这样,module-info 负责模块可见性与服务契约声明,真正的“插拔”逻辑由 Java 代码控制——既合规于 JPMS,又获得运行时灵活性。
不复杂但容易忽略:module-info 是地基,不是吊车。动态插拔得靠上面搭的调度系统来完成。










