用途:ddd4j-extensions 面向 ddd4j 框架的可选扩展,帮助开发者判断某个需求应由哪个扩展覆盖,并指导以可选依赖方式接入、配置与审查。当前 3.0.x 顶层扩展包括 Excel、License、Monitor、OTel、PF4J、QLExpress、QRCode、Validation;Jackson 核心工具位于 ddd4j-kit/core,Akka 主要位于 ddd4j-boot。
主要能力:扩展选型与集成;核心/扩展/运行时边界划分;可选依赖与生命周期管理;扩展测试与降级验证。选择矩阵:Excel 对应 extension-excel,License 对应 extension-license,日志/告警配置对应 extension-monitor,追踪/指标对应 extension-otel,插件系统对应 extension-pf4j,规则表达式对应 extension-qlexpress,二维码对应 extension-qrcode,扩展校验对应 extension-validation。
使用方式:先读取当前根 POM 与目录,确认目标扩展在当前维护线存在;再以可选依赖接入,实现类路径守卫与启用开关,保留用户 Bean 覆盖;对 QLExpress 限制函数、访问类型与超时,对 PF4J 应用签名、来源、隔离与权限策略;明确资源归属并实现显式、幂等的 close;最后测试正常、禁用、类路径缺失与关闭路径。
适用场景:扩展选型、可选依赖接入、插件与规则表达式沙箱、扩展降级审查。
限制:不适用于 Jackson/JsonKit 核心工具(用 ddd4j-kit)、OpenTelemetry 指标设计(用 ddd4j-metrics)、Akka(用 boot 线技能)或通用 PF4J/QLExpress/EasyExcel 用法。不得将历史或仅 Boot 的扩展当作当前核心模块,不得绕过 License 校验或运行未检查的插件。缺失事实:具体版本号、安装命令与外部服务要求暂未提供。