知识卡片
方法名称应对应实际业务责任
执行动作的方法可用postPayment、save等动作词;询问状态的isPosted则应只陈述是否已入账这一事实。命名之前先确认方法负责查询、修改还是创建,结果应描述该责任的业务结果。不要为迎合调用方分支而把动作结果命名成“是否跳过”,也不能用get外观隐藏额外修改;具体前缀仍应遵守所处接口约定。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第2章 有意义的命名
- · 第3章 函数
- · 第15章 JUnit内幕
原书出处 · 4 处
- 第2章 有意义的命名 2.9 类名 · 查看原书依据
方法名应当是动词或动词短语
- 第3章 函数 3.9.2 错误处理就是一件事 · 查看原书依据
函数是语言的动词,类是名词
- 第15章 JUnit内幕 15.1 JUnit框架(续) · 查看原书依据
该函数返回一条格式化后的消息
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
Returns the difference (in days)
参考来源
- 位置:《代码整洁之道》全书 · 第2章 有意义的命名,spine011单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0009.xhtml。
- 结论依据:原文动作、get/set/is三类例子支持先按方法责任区别命名;调用方路由名称的限制是据责任原则补充的适用边界,未声称原文列了该术语。未在本机运行示例或改变环境。
- 原始内容:。类名不应当是动词。 2.10 方法名 方法名应当是动词或动词短语,如postPayment、deletePage或save。属性访问器、修改器和断言应该根据其值命名,并依Javabean标准 [10] 加上get、set和is前缀。