知识卡片
错误码是外部契约
错误码一旦提供给调用者,便成为识别失败和决定后续动作的契约,应尽早统一并考虑演进兼容。编号式错误码结构固定,但需解释文档和容量规划;语义式错误码可按类型、场景和标识组织,如B_Customer_NameAlreadyExist,更易读但仍需稳定定义。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
- · 错误码是外部契约
原书出处 · 1 处
- · 查看原书依据
错误码已经对前端或者外部系统进行了透出,再重构的可能性就很小了。 不同的软件可以有不同的错误码规范策略,这里总结了以下两种方式。 (1)编号错误码 对于平台、底层系统或软件产品,可以采用编号式的编码规范,好处是编码风格固定,给人一种正式感;缺点是必须要配合文档才能理解错
参考来源
- 位置:《代码精进之路:从码农到工匠(异步图书)》2.3.5 异常规范(spine1;extracted/代码精进之路:从码农到工匠(异步图书)/_epub-src/OEBPS/text00000.html;u035-ch02-011)。
- 结论依据:原文在“错误码已经对前端或者外部系统进行了透出”附近的定义、实例或代码支撑本卡的核心说明:错误码一旦提供给调用者,便成为识别失败和决定后续动作的契约,应尽早统一并考虑演进兼容。适用边界按该处前提解释,代码未执行。
- 原始内容:错误码已经对前端或者外部系统进行了透出,再重构的可能性就很小了。 不同的软件可以有不同的错误码规范策略,这里总结了以下两种方式。 (1)编号错误码 对于平台、底层系统或软件产品,可以采用编号式的编码规范,好处是编码风格固定,给人一种正式感;缺点是必须要配合文档才能理解错