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

事件名称为什么应该使用过去式

事件名称为什么应该使用过去式

领域建模里,命令和事件经常只差一个词形,却表达完全不同的语义。把“想做什么”和“已经发生什么”写成同一种名字,会让代码、日志和消息流都变得含糊。本课用 CreateOrder 与 OrderCreated 建立清晰边界。

学习目标

  • 区分命令表达的业务意图与领域事件表达的既成事实
  • 能用过去式为领域事件命名,并识别容易混淆的反例
  • 理解命名如何影响处理流程、日志阅读和系统解耦

命令和事件回答的是两个问题

命令回答“现在希望系统做什么”。CreateOrder 是一个请求,系统收到它后仍然可能因为库存不足、参数非法或业务规则不满足而拒绝执行。命令本身不能证明订单已经存在。

领域事件回答“业务上已经发生了什么”。OrderCreated 只有在创建订单的业务规则通过、聚合状态完成变更之后才成立。它描述的是事实,而不是请求,因此消费者通常不能再“拒绝”这个事实,只能决定如何响应它。

类型 典型名称 语义 是否可能被拒绝
命令 CreateOrder 请创建订单 可以
领域事件 OrderCreated 订单已经创建 不应把事件当成待审批请求
命令 CancelOrder 请取消订单 可以
领域事件 OrderCancelled 订单已经取消 事实已经发生

同一业务动作里,命令和事件常常成对出现,但它们并不是同一条消息改个名字。命令触发决策,事件记录决策成功后产生的业务事实。

过去式让事件语义不可误读

事件名称使用过去式,最重要的作用不是语法统一,而是强制团队确认“这件事到底发生了没有”。OrderCreated、PaymentReceived、ShipmentDispatched 都天然带有完成语义,阅读事件流时可以直接按事实理解。

相反,CreateOrderEvent、PayOrderEvent、OrderCreate 这类名字仍然像动作指令。看到它们时,开发者无法立即判断这是请求、任务、通知,还是已完成的业务事实,后续就容易把事件处理器写成第二套业务决策入口。

从处理链路看命名边界

以创建订单为例,应用层先接收 CreateOrder,再调用领域模型执行规则。只有聚合确认可以创建并完成状态变化后,才产生 OrderCreated。之后,库存、通知、积分等其他能力可以订阅这个事件继续工作。

这条边界也解释了为什么事件处理器不应该重新判断“订单能不能创建”。这个判断属于命令处理阶段;事件到达时,消费者面对的是“订单已经创建”这一事实。

如果事件名称仍使用现在时或祈使语气,链路中的职责很容易倒置:某个消费者可能把事件误认为任务,再次尝试执行创建操作,产生重复写入或难以追踪的幂等问题。

选择能表达业务事实的名称

过去式只是第一层要求,名称还需要使用业务语言。OrderUpdated 虽然是过去式,但信息过于宽泛:价格变了、地址变了、状态变了都可能叫“更新”。如果这些变化具有不同业务含义,应分别表达为 DeliveryAddressChanged、OrderConfirmed、OrderCancelled 等事实。

也不要把技术动作当成领域事件。OrderSaved、RowInserted、CacheRefreshed 描述的是实现细节,不代表领域里有重要业务事实。只有当业务人员也关心并能理解这件事时,它才更接近合适的领域事件。

命令用动词表达意图,事件用过去式表达已经发生的事实。保持这个简单约束,能够让模型中的决策点和事实边界一眼可见,也让事件流更接近一份可阅读的业务历史。

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

目录与阅读设置

阅读设置

17

记录一个想法

事件名称为什么应该使用过去式

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

登录哪都通