Characteristics of Good APIs

什麼是好的API？ 雖然這個概念本質上是主觀的，但大多數
圖書館開發者似乎同意一個的主要理想特徵
API。 下面的列表是由Joshua Bloch 1的一篇演講和一篇文章的啓發
Matthias Ettrich 2：
•易於學習和記憶
•引導可讀代碼
•難以濫用
•易於擴展
•完成
觀察到“minimal”和“consistent”不會出現在列表中。 他們
不需要; 一個a腫，不一致的API將很難學會和mem-
orize，也很難延伸。 我們應該努力實現最低限度，
一致性，但只是在它們有助於滿足標準的程度
以上所列。
“一致性”與“概念完整性”大致相符，
一個複雜的系統應該有一個連貫的設計，反映
一個建築師的願景。 幾十年前，弗雷德裏克·布魯克寫了3：
我認爲概念完整性是最重要的系統設計。 最好有一個系統省略某些異常特徵和改進，但要體現一套設計思路，比一套包含很多良好但獨立和不協調的想法.
順便說一句，如果你有幸擴展一個圖書館al-準備在上文列出，模擬快速跟蹤。