为什么API设计很重要?
- api可能是公司最宝贵的资产之一
- 使用者在购买、使用、学习方面投入巨大
- 停止使用API的成本可能会令人望而却步
- 成功的公共API能捕获客户
- 也可能是公司最大的负债之一
- 糟糕的API会导致持续的维护成本
- 公共api只有一次机会把它做好
为什么API设计对你很重要?
- 如果你编程,你就是一个api设计者
- 好的代码是模块化的——每个模块都有一个api
- 有用的模块往往会被重用
- 模块一旦有了用户,就不能随意更改api
- 好的可重用模块是公司资产
- 从api的角度思考可以提高代码质量
一个好的API的特征
- 易学
- 易于使用,即使没有文档
- 不易误用
- 易于阅读和维护使用它的代码
- 足够强大以满足需求
- 易于扩展
- 适用于使用者
大纲
- API设计过程
- 一般原则
- 类的设计
- 方法设计
- 异常设计
- 重构API设计