知识卡片
精确限定优于无关的长前缀
Address若可能表示邮政、MAC或Web地址,PostalAddress等限定说明的是对象本身的区别,优于附带某应用或账号模块的长标签。给实例命名accountAddress能说明其使用角色,给可复用类型则应描述它代表什么。先分清类型含义与局部用途,才知道哪些词必要。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第2章 有意义的命名 2.17 不要添加没用的语境 · 查看原书依据
这样的名称更为精确,而精确正是命名的要点
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元007;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文Address实例名与PostalAddress/MAC/URI类型名对照,直接支持局部角色和对象类别的限定信息不同。未在本机运行示例或改变环境。
- 原始内容:stalAddress、MAC和URI。这样的名称更为精确,而精确正是命名的要点。 2.18 最后的话 取好名字最难的地方在于需要良好的描述技巧和共有文化背景。与其说这是一种技术、商业或管理问题,还不如说是一种教学问题。其结果是,这个领域内的许多人都