知识卡片

普通读书笔记卡 · 6068.d

一概念约定一称谓

理解等级:中级

团队应为同一种概念约定稳定称谓,减少读者猜测fetch、retrieve和get有何区别。可进一步约定get查单个、list查多个、page分页、count计数。真正不同的契约仍应在命名或接口说明中区分,不能为统一词形抹掉行为差异。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      每个概念对应一个词,并且一以贯之。例如,fetch、retrieve、get、find和query都可以表示查询的意思,如果不加约定地给多个类中的同种查询方法命名,你怎么记得是哪个类中的哪个方法呢?同样,在一段代码中,同时存在manager、controller和han

    参考来源

    - 位置:《代码精进之路:从码农到工匠(异步图书)》1.4.1 每个概念一个词(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u016-ch01-009)。 - 结论依据:原文在“每个概念对应一个词”附近的定义、实例或代码支撑本卡的核心说明:团队应为同一种概念约定稳定称谓,减少读者猜测`fetch`、`retrieve`和`get`有何区别。适用边界按该处前提解释,代码未执行。 - 原始内容:每个概念对应一个词,并且一以贯之。例如,fetch、retrieve、get、find和query都可以表示查询的意思,如果不加约定地给多个类中的同种查询方法命名,你怎么记得是哪个类中的哪个方法呢?同样,在一段代码中,同时存在manager、controller和han