面向多JVM目标的Kotlin库开发:如何实现按类路径运行时选实现的公共API架构
纯JVM生态下多实现动态匹配架构落地方案
你之前尝试KMP遇到的适配痛点本质是技术栈选错——这套“统一公共API层+多实现解耦+运行时动态选择”的场景是JVM生态非常成熟的通用架构,完全不需要引入跨平台编译的复杂度,100%满足你沉淀JVM通用逻辑的需求。
模块拆分规范
将整个库拆分为三个完全解耦的独立JVM模块,无任何编译期硬绑定:
my-library-api:纯公共能力层,零业务实现依赖,只放统一API入口、跨实现通用逻辑(比如你提到的非空校验、参数标准化、通用序列化、错误码映射),所有可复用的Kotlin/JVM代码全部沉淀在这里,业务方仅需编译期依赖这个模块即可完成全量开发,编译期完全看不到任何具体实现类。my-library-mysql:MySQL场景适配实现,依赖公共API模块,引入MySQL驱动、ORM工具等专属依赖,落地具体的存储逻辑。my-library-mongodb:MongoDB场景适配实现,同样依赖公共API模块,引入MongoDB驱动,落地对应存储逻辑。
运行时动态实现选择的两种可落地方案
方案1:JDK原生SPI机制,零额外依赖
这是最贴近你需求的原生实现,不需要引入任何第三方库:
- 在公共API层定义抽象操作接口,替代原代码里的私有
actuallyStoreData方法:// 定义在my-library-api模块中 interface StorageOperations { fun doStore(data: String) } - 公共层的统一入口承载全部通用逻辑,通过SPI加载实现:
// 定义在my-library-api模块中 object DataStore { // 懒加载类路径下的可用SPI实现 private val storageImpl: StorageOperations by lazy { ServiceLoader.load(StorageOperations::class.java).firstOrNull() ?: throw IllegalStateException("类路径下未找到可用存储实现,请引入对应MySQL/MongoDB适配包") } // 对外暴露的统一入口,通用校验逻辑完全沉淀在公共层 fun storeData(data: String) { if (data.isEmpty()) { throw IllegalArgumentException("data cannot be empty") } storageImpl.doStore(data) } } - 两个实现模块分别做SPI声明:在各自资源路径的
META-INF/services目录下,创建以StorageOperations全限定名为文件名的配置文件,文件内容写入自身实现类的全限定名即可。运行时JDK会自动扫描类路径下所有符合规则的实现,业务方引入哪个实现包就加载哪个。
方案2:类路径探测动态加载,适配灵活场景
如果你不想用SPI的配置文件声明方式,可以在公共层的初始化逻辑中直接探测类路径下的核心依赖,动态实例化对应实现:
// 公共层的懒加载逻辑 private val storageImpl: StorageOperations by lazy { when { // 探测类路径是否存在MySQL驱动核心类 runCatching { Class.forName("com.mysql.cj.jdbc.Driver") }.isSuccess -> { // 反射实例化MySQL实现类 Class.forName("com.example.mysql.MysqlStorageImpl").getDeclaredConstructor().newInstance() as StorageOperations } // 探测类路径是否存在MongoDB驱动核心类 runCatching { Class.forName("com.mongodb.client.MongoClients") }.isSuccess -> { Class.forName("com.example.mongodb.MongoStorageImpl").getDeclaredConstructor().newInstance() as StorageOperations } else -> throw IllegalStateException("未识别到类路径下的存储依赖,请引入对应实现包") } }
这种方式不需要实现类额外做SPI声明,只要类路径存在对应驱动就自动匹配,适合需要兼容多版本第三方依赖的场景,缺点是需要维护实现类的全限定名,反射调用的维护成本略高。
落地关键注意事项
- 公共API层绝对不能在编译期引用任何具体实现模块的类,所有跨实现的通用逻辑全部沉淀在API模块,保证业务方仅依赖API的jar即可完成无编译错误的全量开发。
- 实现模块对业务方的依赖范围要标记为
runtimeOnly,避免编译期暴露实现类细节。 - 可以给实现匹配逻辑增加优先级规则,当类路径同时存在两个实现包时,优先加载指定实现,或者抛出明确的依赖冲突提示,避免运行时选型混乱。
内容的提问来源于stack exchange,提问作者theincxption
相关产品推荐
相关产品推荐

