知识卡片
同层步骤应隐藏下一层实现
一个函数可以有多个步骤,只要它们共同解释名字承诺的一件事,并处于相近抽象层。例如渲染测试页可先处理设置/拆解再取得HTML;具体怎样拼接换行或解析路径放到下一层。高层意图与低层字符操作混在一起,会让读者不断切换问题。抽象层不是按语句类型固定划分,而应看它对当前任务表达的细节程度。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第3章 函数
原书出处 · 3 处
- 第3章 函数 3.3 每个函数一个抽象层级 · 查看原书依据
函数中的语句都要在同一抽象层级上
- 第17章 味道与启发 17.4 一般性问题 · 查看原书依据
所有较低层级概念放在派生类中
- 第17章 味道与启发 17.4 一般性问题(续) · 查看原书依据
函数render只构造一个hr标记
参考来源
- 位置:《代码整洁之道》全书 · 第3章 函数,spine012单元003;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0010.xhtml。
- 结论依据:原文以getHtml、PathParser.render和append换行三层对照,直接支持同层组织;上一单元的三个渲染步骤说明一件事不等于一条语句。未在本机运行示例或改变环境。
- 原始内容:函数一个抽象层级 要确保函数只做一件事,函数中的语句都要在同一抽象层级上。一眼就能看出,代码清单3-1 违反了这条规矩。那里面有 getHtml( )等位于较高抽象层的概念,也有 String pagePathName = PathParse