SuperAPI AI 工具集

ddd4j-annotation

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:按注解的消费者与运行时语义来选择、应用、审查或扩展 ddd4j 注解,避免仅凭注解名称推断其会注册 Bean、持久化字段或触发事件。

主要能力:覆盖四类注解族——ddd/Contract(领域分类与元数据,如 Contract、BusinessType、DDDAnnotation)、cqrs(CreateEvent、UpdateEvent、DeleteEvent)、api(ApiIdempotent、ApiModule、ApiOperationLog、RawResponse)、orm(DomainField、TenantId、SystemId、BizKey、OnCreate、OnUpdate、OrderBy)。

使用方式:应用前检查 Retention、Target、默认值与消费者;RUNTIME 保留仅表示可反射可见,不代表框架自动处理。ORM 注解由 DomainModelHelper、仓储或拦截器消费;API 注解的行为须由 Web/Runtime 适配器实现。新增注解需附带独立性、默认值、Target 与消费者测试,并核对各维护线的 Java/Jakarta 包名差异。

适用场景:为新字段、方法或类选择注解族;为 PO 添加 @BizKey、@TenantId、@OnCreate 等并接通消费者;为端点添加幂等、模块、操作日志注解;用事件注解标记聚合状态变更;审查现有注解用法;引入新注解及其测试集。

限制:不用于设计聚合、命令或查询模型(用 ddd4j-core),不决定注解消费者归属模块(用 ddd4j-architecture),不实现 Web/Runtime 适配器(用 ddd4j-web 或 ddd4j-runtime),不构建 ORM 注解背后的仓储与持久化行为(用 ddd4j-data)。不得因注解存在就宣称功能可用;不得把 Spring、Quarkus 或 JPA 注解当作 ddd4j 注解;不得未经兼容性审查更改 Retention 或 Target。缺少消费者时返回 missing: runtime handler,并确认目标 Web/Data/Runtime 模块。本技能不访问、不收集、不存储、不传输任何用户数据、凭据或密钥。