架构与系统设计 / 系统课时

命令名称为什么不要写成 CRUD

命令名称为什么不要写成 CRUD

在事件风暴里,命令的名字不是技术接口名,而是业务意图的浓缩。把卡片写成 UpdateOrder、ModifyUser 一类 CRUD 名称,会隐藏真正要做的事;改成“取消订单”“修改收货地址”等动作,领域规则才会自然暴露出来。

学习目标

  • 区分数据操作名称与业务命令名称
  • 从命令名称中识别权限、前置条件和业务规则
  • 用业务语言重命名过于宽泛的 CRUD 命令

CRUD 名称隐藏了什么

UpdateOrder 只说明“订单数据发生更新”,却没有回答更新什么、为什么更新、谁可以更新。它可能同时代表取消订单、修改地址、补充备注或调整发票信息,而这些动作通常拥有完全不同的约束。

例如,“取消订单”可能要求订单尚未发货;“修改收货地址”可能只允许在仓库锁单前发生。两者如果都塞进 UpdateOrder,事件风暴现场就很难继续追问对应规则,也容易把领域模型做成一个接收任意字段的通用更新接口。

宽泛名称 更合适的业务命令 能暴露的关键问题
UpdateOrder CancelOrder 哪些状态允许取消?是否需要退款?
UpdateOrder ChangeShippingAddress 何时还能改地址?谁有权限修改?
UpdateRefund ApproveRefund 谁能审批?金额是否需要分级授权?

从业务意图命名命令

命令名应回答“希望系统完成什么业务动作”。优先使用团队真实说法中的动词和领域对象,并让一个名称只表达一个主要意图。

可以用三个检查问题判断名称是否合格:

  1. 业务人员看到名称后,是否能直接说出这个动作的目的。
  2. 名称变化后,是否会带出不同的权限、状态条件或计算规则。
  3. 命令成功后,是否能自然联想到一个明确的过去式事实,例如 CancelOrder 对应“订单已取消”。

下面的 Java 示例不是事件风暴工具代码,而是把不同业务意图映射成不同命令类型,展示这种命名如何进入实现。

java
public class CommandNamesDemo {
    record CancelOrder(String orderId, String reason) {}
    record ChangeShippingAddress(String orderId, String newAddress) {}

    public static void main(String[] args) {
        System.out.println(new CancelOrder("O-1001", "用户不再需要").getClass().getSimpleName());
        System.out.println(new ChangeShippingAddress("O-1001", "上海市徐汇区").getClass().getSimpleName());
    }
}

预期输出

text
CancelOrder
ChangeShippingAddress

这里的重点不是 Java record,而是两个类型携带了不同信息:取消订单需要原因,修改地址需要新地址。业务意图越明确,命令需要的数据和校验条件通常也越容易确定。

什么时候可以使用 Create、Delete

CRUD 词并非绝对禁止。如果业务本身真的把动作称为“创建”或“删除”,且没有更具体的领域含义,例如后台维护一个纯配置项,CreateRule 可能已经足够清楚。

但只要某个“更新”动作会触发专门规则、权限、通知、退款、库存变化或状态迁移,就应该继续追问它真正代表的业务动作。事件风暴中的命令名越接近业务人员的语言,后续聚合、策略和领域事件就越容易从流程中被发现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

命令名称为什么不要写成 CRUD

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通