API设计准则

来源:互联网 发布:整站优化 编辑:程序博客网 时间:2024/05/07 03:26
API必须要提供充分的功能,以供调用者完成自己的任务。
API应该是最精简的,不要为调用者带来多余的不便。
如果没有理解API的使用环境的话,那也就不能去设计它。
通用性的API应当是与具体使用场景无关的,而特定用途的API则要充分考虑使用策略。
API应该从调用者的角度来进行设计。
好的API绝不推卸责任,把自己该做的事情留给别人。
在实现API之前,就应该把API文档化。
好的API应当符合工效学(Ergonomic)。

本文转自
http://jcrandomthought.spaces.live.com/Blog/cns!D5A79766001AF61!387.entry