知识卡片
SRP只对一类行为者负责
SRP 常被误解为“每个模块只做一件事”。它的最终表述是:任何软件模块都应只对某一类行为者负责,行为者指提出相似变更需求的一群人。Employee 类中 calculatePay 服务 CFO,reportHours 服务 COO,save 服务 CTO;两者共用的 regularHours 被 CFO 团队修改后,COO 的报表悄悄出错,造成数百万美元损失。把不同行为者依赖的代码放在一起,会让一方的变更波及另一方。
结构图: 类图(依赖箭头指向被使用的类型;空心三角表示实现或继承;未给出参数和返回值的方法只保留原文方法名):
classDiagram
class Employee {
calculatePay()
reportHours()
save()
regularHours()
}
note for Employee "calculatePay与reportHours都调用regularHours;三类行为者的变更被集中到一个类型"
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 3 处
- · 查看原书依据
这样,每个软件模块都有且只有一个需要被改变的理由。
- · 查看原书依据
任何一个软件模块都应该只对某一类行为者负责。
- · 查看原书依据
这三个函数被放在同一个源代码文件,即同一个Employee类中,程序员这样做实际上就等于使三类行为者的行为耦合在了一起,这有可能会导致CFO团队的命令影响到COO团队所依赖的功能。
参考来源
- 位置:《架构整洁之道》第7章《SRP:单一职责原则》"反面案例1:重复的假象""反面案例2:代码合并"(源文件:_epub-src/text/part0012_split_001.html)
- 结论依据:原文纠正"SRP=每个模块只做一件事"的常见误解,给出"只对某一类行为者负责"的最终定义,并用Employee类三个函数共享regularHours()逻辑、CFO团队改动意外破坏COO团队报表的真实案例说明违反SRP导致的隐蔽耦合风险,直接支撑本卡片结论。
- 原始内容:任何一个软件模块都应该只对某一类行为者负责……calculatePay()函数调用了regularHours()函数,但可能不会注意到该函数会同时被reportHours()调用……HR 仍然在使用reportHours()产生的报表,随后就会发现他们的数据出错了!