知识卡片
业务命名优先
函数名要表达具体业务责任,而非含糊的“处理数据”或偶然实现。例如面向业务的getLatestEmployee()比popRecord()更能说明取最近雇员;但在栈接口本身,pop仍是合适的抽象。先确定接口服务哪一层,再选择这一层读者能理解的词。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 业务命名优先
原书出处 · 1 处
- · 查看原书依据
函数的命名要体现做什么,而不是怎么做。假如我们将雇员信息存储在一个栈中,现在要从栈中获取最近存储的一个雇员信息,那么getLatestEmployee()就比popRecord()要好,因为栈数据结构是底层实现细节,命名应该提升抽象层次、体现业务语义。合理的命名可以使你
参考来源
《代码精进之路:从码农到工匠(异步图书)》第1章《命名》
- 位置:《代码精进之路:从码农到工匠(异步图书)》1.3.2 函数名(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u011-ch01-002)。
- 结论依据:原文在“函数的命名要体现做什么”附近的定义、实例或代码支撑本卡的核心说明:函数名要表达具体业务责任,而非含糊的“处理数据”或偶然实现。适用边界按该处前提解释,代码未执行。
- 原始内容:函数的命名要体现做什么,而不是怎么做。假如我们将雇员信息存储在一个栈中,现在要从栈中获取最近存储的一个雇员信息,那么getLatestEmployee()就比popRecord()要好,因为栈数据结构是底层实现细节,命名应该提升抽象层次、体现业务语义。合理的命名可以使你