知识卡片
短函数以职责衡量
超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。行数阈值可以作为团队发现问题的提醒,但不是正确性的证明;拆分后若名称无意义、上下文频繁跳转,也未必改善阅读。最终检查的是职责和表达。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 2 处
- · 查看原书依据
没有一个绝对的量化标准,各团队可以有自己的标准,不同的开发语言可能会稍有不同。如果是Java语言,我建议一个方法不要超过20行代码,当我把这个规定作为团队代码审查的硬性指标后,发现代码质量得到了显著的改善。
- · 查看原书依据
短函数也不一定就意味着职责单一。 (2)在使用组合函数模式时,要注意抽象层次一致性原则(Single Level of Abstration Principle,SLAP),不同抽象层次的内容放在一起会给人凌乱、逻辑不协调的感觉。
参考来源
- 位置:《代码精进之路:从码农到工匠(异步图书)》3.5 短小的函数(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u045-ch03-008)。
- 结论依据:原文在“没有一个绝对的量化标准”附近的定义、实例或代码支撑本卡的核心说明:超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。适用边界按该处前提解释,代码未执行。
- 原始内容:没有一个绝对的量化标准,各团队可以有自己的标准,不同的开发语言可能会稍有不同。如果是Java语言,我建议一个方法不要超过20行代码,当我把这个规定作为团队代码审查的硬性指标后,发现代码质量得到了显著的改善。
- 位置:《代码精进之路:从码农到工匠(异步图书)》9.2 函数分解(spine2;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00001.html;u147-ch03-008)。
- 结论依据:原文在“短函数也不一定就意味着职责单一”附近的定义、实例或代码支撑本卡的核心说明:超长函数常把多个阶段和职责挤在一起,可按逻辑拆成有意义的子函数以便理解。适用边界按该处前提解释,代码未执行。
- 原始内容:短函数也不一定就意味着职责单一。 (2)在使用组合函数模式时,要注意抽象层次一致性原则(Single Level of Abstration Principle,SLAP),不同抽象层次的内容放在一起会给人凌乱、逻辑不协调的感觉。