知识卡片
返回新值的方法应显露结果用途
日期方法经工厂创建并返回新DayDate,没有修改接收者。若调用者只写date.addDays(7)而忽略返回值,可能误以为原日期已前进。plusDays/plusMonths的命名可提示新值组合,并应在契约与调用处接收结果;单靠名称仍不能保证所有读者理解,更不能将返回值改成调用者是否该继续的布尔。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 6 处
- 第16章 重构SerialDate 16.2 让它做对(续) · 查看原书依据
返回了一个DayDate的新实体
- 第17章 味道与启发 17.4 一般性问题(续) · 查看原书依据
该date实体会变化吗
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
return SerialDate.createInstance(serialDayNumber);
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
return SerialDate.createInstance(targetD, baseM, targetY);
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
public void testAddDays()
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
return DayDateFactory.makeDate(getOrdinalDay() + days);
参考来源
- 位置:《代码整洁之道》全书 · 第16章 重构SerialDate,spine025单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0023.xhtml。
- 结论依据:原文静态改实例后识别歧义、plus命名及赋值/丢弃两例支持方法结果语义,核心是新日期而非路由信号。未在本机运行示例或改变环境。
- 原始内容:不是明确地表示了date对象并没变动以及返回了一个DayDate的新实体呢?或者,它只是错误地暗示我们往date对象添加了5天呢?你可能不会认为这是个大问题,但下列代码却可能会有欺骗性。 DayDate date = DateFactory.