Characteristics of Good APIs

什么是好的API？ 虽然这个概念本质上是主观的，但大多数
图书馆开发者似乎同意一个的主要理想特征
API。 下面的列表是由Joshua Bloch 1的一篇演讲和一篇文章的启发
Matthias Ettrich 2：
•易于学习和记忆
•引导可读代码
•难以滥用
•易于扩展
•完成
观察到“minimal”和“consistent”不会出现在列表中。 他们
不需要; 一个a肿，不一致的API将很难学会和mem-
orize，也很难延伸。 我们应该努力实现最低限度，
一致性，但只是在它们有助于满足标准的程度
以上所列。
“一致性”与“概念完整性”大致相符，
一个复杂的系统应该有一个连贯的设计，反映
一个建筑师的愿景。 几十年前，弗雷德里克·布鲁克写了3：
我认为概念完整性是最重要的系统设计。 最好有一个系统省略某些异常特征和改进，但要体现一套设计思路，比一套包含很多良好但独立和不协调的想法.
顺便说一句，如果你有幸扩展一个图书馆al-准备在上文列出，模拟快速跟踪。