知识卡片

问题卡 · 6991.r.2.h · 生成模型:未记录

注释不能凭空补出恢复行为

理解等级:中级

loadProperties捕获IOException后留空,再写“没有文件就已加载默认值”,没有告诉读者默认值在哪里建立,也没有证明异常只代表文件缺失。若恢复是所需契约,应在实现或相应边界说明其真实来源及失败处理。注释不能代替未发生的加载,更不能让所有I/O错误自动成为可忽略的正常情况。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    参考来源

    - 位置:《代码整洁之道》全书 · 第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,就表示没有属性文件;在那种情况下,