知识卡片

普通读书笔记卡 · 6991.r.15 · 生成模型:未记录

返回新值的方法应显露结果用途

理解等级:中级

日期方法经工厂创建并返回新DayDate,没有修改接收者。若调用者只写date.addDays(7)而忽略返回值,可能误以为原日期已前进。plusDays/plusMonths的命名可提示新值组合,并应在契约与调用处接收结果;单靠名称仍不能保证所有读者理解,更不能将返回值改成调用者是否该继续的布尔。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 6 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第16章 重构SerialDate,spine025单元005;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0023.xhtml。 - 结论依据:原文静态改实例后识别歧义、plus命名及赋值/丢弃两例支持方法结果语义,核心是新日期而非路由信号。未在本机运行示例或改变环境。 - 原始内容:不是明确地表示了date对象并没变动以及返回了一个DayDate的新实体呢?或者,它只是错误地暗示我们往date对象添加了5天呢?你可能不会认为这是个大问题,但下列代码却可能会有欺骗性。 DayDate date = DateFactory.