Clean Architecture中的"use-cases"是什么?用例划分与联合更新问题解析
Clean Architecture 落地中的Use Case边界澄清
你之前把数据合法性校验收敛在Employee、Department等实体层的思路是完全正确的,这也是Clean Architecture实体层的核心职责,偏差主要出在Use Case的边界判断上,针对你提出的几个问题逐一说明:
你列的Use Case文件的合规性判断
add-employee.js、remove-employee-by-id.js是完全符合规范的Use Case:二者对应独立、完整的外部业务请求意图,有明确的输入输出规则,可被Controller、定时任务、消息消费者等外部层直接触发调用。update-employee-department.js、update-employee-phone-number.js本身的文件结构没有问题,但是否属于合理的Use Case,核心取决于拆分粒度的判断标准——很多开发者在这一步会陷入形式主义的误区。
Use Case的拆分粒度,不需要强制按单字段拆分
首先要厘清一个最常见的认知偏差:Use Case不是“实体能执行的所有动作的集合”。
Use Case的核心定位是应用层向外暴露的业务交互边界,判断一个操作是不是独立的Use Case,核心看两个维度:
- 这个操作能不能作为一个独立的业务意图被外部单独发起?比如HR系统里,“调整员工所属部门”往往是独立的操作场景:有单独的权限控制、单独的操作日志、会触发部门成员统计、权限组调整等后续流程,这种情况下它作为独立Use Case是完全合理的。
- 这个操作有没有独立的、专属的业务校验规则?如果某个字段的修改没有独立规则,只是同一个业务表单下的多个字段提交(比如员工自助页同时修改手机号、邮箱、所属部门的个人信息提交),那把它拆成多个单字段Use Case就是纯过度拆分。
很多人学Clean Architecture学偏了,追求“一个动作一个文件”,最后搞出几十上百个空壳Use Case,每个文件里就三行代码:查实体、调set方法、存实体,纯纯的形式主义,没有任何业务价值。
这里要特别区分实体内部方法和Use Case:
你在Employee类里封装的updatePhone()、assignDepartment()这类方法,本质是为了把数据合法性校验收敛在实体内部的实现逻辑,根本不是Use Case。Use Case只需要按业务场景组织,在场景流程里调用这些实体方法即可,不需要把每个实体方法都映射成一个独立的Use Case文件。
多字段更新不需要拆成多次数据库调用
你担心的“同时改两个字段要拆两次DB交互”的问题,本质是把错误拆分的细粒度操作等同于Use Case后的结果,不是Clean Architecture本身的设计要求。
正常的单Use Case执行链路完全匹配你想要的单次DB交互逻辑:
- 承接外部传入的、对应完整业务场景的入参
- 调用仓储抽象接口(数据库适配器是这个接口的具体实现,不是直接把适配器的具体操作硬编码给每个细粒度流程),一次性加载完整的Employee实体
- 在同一个流程里调用实体的多个字段更新方法,逐次完成所有字段的合法性校验
- 全量校验通过后,一次性将修改后的实体提交回仓储接口,由数据库适配器完成单次完整的写入操作,甚至可以在适配器层按需开启事务、做批量优化。
如果业务端真的有“同时更新部门和手机号”的独立场景,正确的做法是新增一个对应这个场景的Use Case(比如update-employee-basic-info.js),而不是去先后调用“只改部门”“只改手机号”两个独立的细粒度Use Case——前者的流程就是你预期的一次查库、一次写库,没有冗余交互。
内容的提问来源于stack exchange,提问作者Darkbound
相关产品推荐
相关产品推荐

