知识卡片

普通读书笔记卡 · 1915.b.7

接口应提前说明意外代价

理解等级:中级

在函数或类的说明中披露调用者难以从名字推断、却会影响使用方式的行为,例如外部服务等待、阻塞或特定输入下急剧增加的计算成本。调用者才能判断是否适合放在请求路径,并安排超时、隔离或输入限制。具体耗时依赖环境和输入,不能把教学示例中的秒数、分钟数当运行保证。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • · 查看原书依据

      有什么出人意料的地方?会不会被误用?”基本上就是说你需要“未雨绸缪”,预料到人们使用你的代码时可能会遇到的问题。 例如,假设你写了一个函数来向给定的用户发邮件: 这个函数的实现包括连接到外部邮件服务,这可能会花整整一秒,或者更久。可能有人在写Web应用时在不知情的情况下

    参考来源

    - 位置:《编写可读代码的艺术》在接口处提前披露意外代价(spine 2800;来源项目book-sources,`extracted/OReilly精品图书系列共21册(《Javascript权威指南》、《机器学习:实用案例解析》、《编写可读代码的艺术》、《算法精解》等)/_epub-src/text/part2724.html`;来源键`s2800-ch05-007`)。 - 结论依据:正文与图103..131完整实读;示例的性能数字、参数及实现细节限定于原例,没有执行或推广为当前通用保证。 - 原始内容:有什么出人意料的地方?会不会被误用?”基本上就是说你需要“未雨绸缪”,预料到人们使用你的代码时可能会遇到的问题。 例如,假设你写了一个函数来向给定的用户发邮件: 这个函数的实现包括连接到外部邮件服务,这可能会花整整一秒,或者更久。可能有人在写Web应用时在不知情的情况下