SuperAPI AI 工具集

ddd4j-kit

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:在业务模块中优先复用 ddd4j 已提供的稳定工具类,避免重复造轮子。覆盖 JsonKit、BeanKit、MappingKit、StrKit、StrPool、CollKit、ArrayKit、IdKit、FunctionKit、DateKit、ReflectKit 等。

主要能力:按场景选择 JSON 映射器——DEFAULT_OBJECT_MAPPER 用于普通 JSON,REDIS_OBJECT_MAPPER 仅用于可信缓存数据,EventStore 使用 EventPayloadSerializer 并显式指定事件类型;区分 BeanKit 与 MappingKit 的 Bean 属性处理及隐式拷贝不安全之处;在采用前核实空值处理、异常契约与泛型;处理 Jackson 2/3 边界,包括 com.fasterxml.jackson.annotation 兼容包;清理 Kit 已提供的重复工具包装。

使用方式:先检索当前维护线的 Kit 源码,再阅读签名、实现与测试,区分纯函数、全局可变映射器与有副作用的工具,选择最窄且不丢失 Optional、异常与泛型的 API,最后测试空值、空集合、超大与畸形输入及错误路径。安装:npx skills add full-stack-skills/ddd4j-skills --skill ddd4j-kit。

适用场景:工具选型、JSON 序列化边界判断、Bean 拷贝、集合与字符串操作、ID 生成、反射工具使用。

限制:不用于领域/CQRS 契约(用 ddd4j-core)、缓存序列化策略(用 ddd4j-cache)、领域到 PO 持久化映射设计(用 ddd4j-data);不把工具类当领域服务,不用 Kit 隐藏事务、网络或资源生命周期;不处理无 ddd4j 参与的通用 Commons/Guava/Hutool 选型。注意:JacksonKit 名称已合并,3.0.x JsonKit 绑定 tools.jackson,REDIS_OBJECT_MAPPER 启用 DefaultTyping 仅限可信数据,BeanKit 静默拷贝可能掩盖字段重命名或类型不匹配,工具异常被吞成 null/false 会制造假成功,3.0.x 签名不向后兼容。本技能不访问、不收集、不存储、不传输任何用户数据、凭据或密钥。