SuperAPI AI 工具集

domain-entity-uuidv4-ids

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:这是一项身份格式规范技能,适用于需要创建、修改、审查或解读领域实体 ID 字段、ID 类型、构造函数与工厂入参、持久化映射、序列化与反序列化,以及跨边界传输标识符的场景。它只规定标识符格式为 UUIDv4,以及底层类型选择;是否将底层类型包装成每个实体独立的类型化 ID(如 OrderId、CustomerId)由 domain-entity-typed-ids 技能负责。

主要能力:当语言或标准库提供内置 UUID 类型时,优先使用该类型承载领域实体 ID,不退化使用无约束字符串;当没有内置 UUID 类型时,使用字符串作为底层标识符类型,并让 UUIDv4 的生成与校验保持显式。同时要求 UUIDv4 语义在内存表示、持久化映射和交换载荷中保持一致。

使用方式:先定位身份边界,找到代表领域实体身份的字段、属性、构造参数、工厂入参或持久化映射;再判断所用技术栈是否提供 UUID 类型,并遵循项目既有的导入、构造与存储约定;随后追踪生成与转换点,确认新建 ID 以 UUIDv4 生成,文本解析、存储转换与跨边界输出处仍强制该格式;最后验证同一 UUIDv4 值能经过构造函数、领域方法、持久化映射、序列化器与外部契约而不丢失含义,并在解析或构造附近对非法输入进行拒绝。

适用场景与限制:适合领域模型、序列化、持久化与通信契约中的标识符处理。资料未提供具体编程语言示例、库名、命令行安装方式、收费标准或实现代码;未提供该技能的具体安装或调用步骤,也未说明可支持的平台范围。