← 返回刚才阅读的位置

知识卡片

普通读书笔记卡 · 1586

最小API是深刻理解问题的标志

理解等级:未标注

完美的设计不是无法再添加什么,而是无法再删去什么——这个标准同样适用于API设计:暴露给使用者 的方法和参数越少,接口越容易理解,维护者也能把更多精力投入到把这些少数方法做到极致完善。 有意识地不解决某些边缘问题、把API范围收窄,反而能让核心问题解决得更彻底。一个很小很简单的 API通常不是能力不足,而是设计者对问题本质有更深刻理解的标志。

这张卡片看不懂?

已有反馈 · 0 条

    还没有人提交反馈。

    在整书笔记中的位置

    原书出处 · 1 处

    • 第9章 简单化 · 查看原书依据

      书写一个明确的、最小的API 是管理软件系统管理简单性必要的部分。我们向API消费者提供的方法和参数越少,这些API就越容易理解,我们就能用更多的精力去尽可能地完善这些方法。同时,一个反复出现的主题是:有意识地不解决某些问题可以让我们能够更专注核心问题,使得我们已有的解决方案更好。在软件工程上,少就是多!一个很小的,很简单的API通常也是一个对问题深刻理解的标志。

    参考来源

    - 位置:《SRE:Google运维解密》第9章《简单化》"最小API"一节(源文件:_epub-src/OEBPS/Text/0008_0007.xhtml) - 结论依据:原文引用圣埃克苏佩里"不是在不能添加更多的时候,而是没有什么可以去掉的时候,才能达到完美",并主张暴露的方法参数越少API越易理解,称"一个很小的,很简单的API通常也是一个对问题深刻理解的标志"。 - 原始内容:“不是在不能添加更多的时候,而是没有什么可以去掉的时候,才能达到完美……我们向API消费者提供的方法和参数越少,这些API就越容易理解……一个很小的,很简单的API通常也是一个对问题深刻理解的标志。”