知识卡片

普通读书笔记卡 · 6067.k

错误码是外部契约

理解等级:中级

错误码一旦提供给调用者,便成为识别失败和决定后续动作的契约,应尽早统一并考虑演进兼容。编号式错误码结构固定,但需解释文档和容量规划;语义式错误码可按类型、场景和标识组织,如B_Customer_NameAlreadyExist,更易读但仍需稳定定义。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      错误码已经对前端或者外部系统进行了透出,再重构的可能性就很小了。 不同的软件可以有不同的错误码规范策略,这里总结了以下两种方式。 (1)编号错误码 对于平台、底层系统或软件产品,可以采用编号式的编码规范,好处是编码风格固定,给人一种正式感;缺点是必须要配合文档才能理解错

    参考来源

    - 位置:《代码精进之路:从码农到工匠(异步图书)》2.3.5 异常规范(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u035-ch02-011)。 - 结论依据:原文在“错误码已经对前端或者外部系统进行了透出”附近的定义、实例或代码支撑本卡的核心说明:错误码一旦提供给调用者,便成为识别失败和决定后续动作的契约,应尽早统一并考虑演进兼容。适用边界按该处前提解释,代码未执行。 - 原始内容:错误码已经对前端或者外部系统进行了透出,再重构的可能性就很小了。 不同的软件可以有不同的错误码规范策略,这里总结了以下两种方式。 (1)编号错误码 对于平台、底层系统或软件产品,可以采用编号式的编码规范,好处是编码风格固定,给人一种正式感;缺点是必须要配合文档才能理解错