SuperAPI AI 工具集

ddd4j-javalin-extensions

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:本技能面向 ddd4j-javalin 扩展的组合与装配场景,覆盖 Guice Module、Modules.override、业务绑定、SPI Provider 以及扩展生命周期管理。使用前应先用 ddd4j-javalin-version-selection 确认维护线,再查阅当前分支源码。

主要能力:为扩展与 Javalin 适配选择实现方案;界定生命周期、配置与行为边界;说明三条维护线之间的差异;可分析现有用法并给出实现选择、证据状态与剩余风险。

使用方式:先固定维护线并定位 extensions 模块、示例与模块组合测试;按默认模块先安装、业务绑定随后通过 Modules.override 覆盖的顺序排列 Guice Module;每个 SPI 契约只注册一个唯一实现;为扩展资源指定显式所有者与幂等关闭。需测试三条组合路径:默认装配、业务覆盖生效、以及类路径上扩展被禁用。

适用场景:在 6.7.x、7.1.x、7.2.x 上组合可选扩展与业务绑定;注册 SPI Provider 并确认每个契约的胜出实现;设定扩展资源的生命周期与失败策略(可选扩展降级、必需扩展显式启动失败);验证扩展公共入口的真实行为。

限制与注意:Modules.override 对顺序敏感,覆盖绑定若早于被覆盖的默认模块会被静默忽略;重复 SPI 实现不会在启动时报错,而是造成运行时不确定性;同一注册不可同时具备降级与启动失败两种语义;关闭按注册逆序执行,扩展清理需与核心资源排序;类路径上存在类不代表组合成功,禁用路径必须实际测试;Javalin 6 与 7 API 不同,跨维护线复制的扩展代码需在各线工具链重新验证。不要将 Javalin 6 代码直接复制到 7,也不要用冒烟测试替代真实行为验证。本技能不访问、收集、存储或传输任何用户数据、凭据或密钥,示例仅使用脱敏虚构数据。输入不足时先给出暂定结论,再列出缺失项及提供方式,如缺少目标维护线、POM 或验收行为则先标注 missing 并继续只读检查。