知识卡片
注释不能凭空补出恢复行为
loadProperties捕获IOException后留空,再写“没有文件就已加载默认值”,没有告诉读者默认值在哪里建立,也没有证明异常只代表文件缺失。若恢复是所需契约,应在实现或相应边界说明其真实来源及失败处理。注释不能代替未发生的加载,更不能让所有I/O错误自动成为可忽略的正常情况。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 第4章 注释
原书出处 · 1 处
- 第4章 注释 4.3.6 TODO注释 · 查看原书依据
No properties files means all defaults are loaded
参考来源
- 位置:《代码整洁之道》全书 · 第4章 注释,spine013单元004;来源项目book-sources,extracted/代码整洁之道/_epub-src/OEBPS/Text/part0011.xhtml。
- 结论依据:原文自己列出默认值来源的多种疑问,空catch没有执行加载代码,直接支持需回到实际恢复责任判断,样板也未提供完整资源关闭。未在本机运行示例或改变环境。
- 原始内容:IOException e) { // No properties files means all defaults are loaded } } catch代码块中的注释是什么意思呢?显然对于作者有其意义,不过并没有好到足够的程度。很明显,如果出现IOException,就表示没有属性文件;在那种情况下,