知识卡片

普通读书笔记卡 · 489.b.1.b.1

接口抽象从用例形成契约

理解等级:初级

接口连接调用方与实现。先理解调用者完成的任务,再提炼稳定概念、输入输出及失败语义,避免只把零散请求堆成大量专用入口或泄露内部结构。

好的抽象减少调用者需要理解的实现细节,但最小接口不等函数越少越好。宽浅与窄深只是比较视角,原文“现代Mac不再使用任何API”显然错误,不据此评价实际平台。

这张卡片看不懂?

已有反馈 · 0 / 10 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 15.5 项目设计 · 查看原书依据

      一个好的开始方法是记录用例,即用API完成一些任务或一组任务的情况。可以通过查询程序的最终用户来收集用例。但请记住,用户通常会给出短视的答案,因为他们已经在使用某些东西了。他们的很多反馈都倾向于“让它们变成这样或那样”。一堆离散的需求并不能得到一个清晰的结论。

    参考来源

    - 位置:《计算机系统解密》15.5 项目设计(来源项目book-sources,源文件:extracted/计算机系统解密/_epub-src/text/part0150.html) - 结论依据:本项全部正文与图表实际读取,区分作者示例、推导与实现边界;纠错另有明确说明。 - 原始内容:一个好的开始方法是记录用例,即用API完成一些任务或一组任务的情况。可以通过查询程序的最终用户来收集用例。但请记住,用户通常会给出短视的答案,因为他们已经在使用某些东西了。他们的很多反馈都倾向于“让它们变成这样或那样”。一堆离散的需求并不能得到一个清晰的结论。