知识卡片
相同词不应掩盖不同操作
若某处add计算两个值的新结果,另一处却把元素放入已有容器,应让调用者看清结果和副作用的不同。可用append、insert等更具体词,或遵守既有API中清楚定义的add契约。书中例子是命名建议,不意味着Java集合等现有协议中的add应一律改名;要比较实际责任,而非单按拼写认定等价。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第2章 有意义的命名 2.9 类名 · 查看原书依据
避免将同一单词用于不同目的
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文由计算新值与向集合插入对照支持语义区别,补充现有协议边界避免将作者偏好误写成所有add都错误。未在本机运行示例或改变环境。
- 原始内容:直就是天降福音。 2.13 别用双关语 避免将同一单词用于不同目的。同一术语用于不同概念,基本上就是双关语了。如果遵循“一词一义”规则,可能在好多个类里面都会有add方法。只要这些add方法的参数列表和返回值在语义上等价,就一切顺利。