知识卡片
不可变承诺要说明状态范围
SerialDate的注释写日期类不可变,但它又公开setDescription修改描述。年月日值不变和对象所有可观察状态不变是不同承诺;使用者若共享整个对象,不能仅由类注释假定没有变化。应明确元数据是否属于不可变值或另行存放,而不是以字段看似无关为由忽略公共修改入口。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 3 处
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
public void setDescription(final String description)
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate · 查看原书依据
Requirement 2 : class is immutable;
- 附录B org.jfree.date.SerialDate 附录B org.jfree.date.SerialDate(续) · 查看原书依据
this.description = description;
参考来源
- 位置:《代码整洁之道》全书 · 附录B org.jfree.date.SerialDate,spine028单元008;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0026.xhtml。
- 结论依据:原文类Javadoc的immutable要求与完整description字段/访问器对照,限定为日期值和整体状态的区别,不推断尚未读的具体实现全部字段安全。未在本机运行示例或改变环境。
- 原始内容:he date. 859 */ 860 public void setDescription(final String description) { 861 this.description = description; 862 } 863 864 /** 865 * Converts the date to a