哈巴狗

如何设计好的接口
【how to design a good api and why it matters】
【joshua bloch from google】

一、好接口的特性
（1）易学；
（2）易用，甚至不需要文档；
（3）难于误用；
（4）容易阅读与维护；
（5）容易扩展；

二、提纲
（1）接口设计实现的过程；
（2）接口设计的基本原则；
（3）类设计；
（4）方法设计；
（5）异常设计；
（6）接口重构；

三、接口设计实现的过程
（1）分析需求；
考虑是否有更佳解决方案？
这是否使我们这真想要的需求？
（2）设计理想化小接口；
这个阶段，快速敏捷迭代；
小接口易于修改；
小接口的实现给人自信，减少挫败感；
（3）高频、提早撰写接口；
实现自测用例；
（4）撰写服务提供接口（SPI：service provider interface）尤为重要；
如果提供一个接口，是否就不支持第二个？
如果提供两个接口，是否能够扩展，融合？
如果提供三个接口，是否足够？能否工作正常？
（5）注意“正常的”异常维护；
你的接口是为了满足所有需求？
即使有异常，也不要紧

四、接口设计的基本原则
（1）只做并做好一件事；
Do One Thing and Do it Well
函数名自解释；
不恰当的函数名，往往是不恰当设计的征兆；
（2）如果没做到（1），就将函数分解；
只增加，永远不要删除函数与接口；
你永远不知道这个接口被谁在使用；
（3）实现永远不能影响接口；
举例：不能假定函数调用者只能使用hash；
不能对外暴露实现细节；
（4）最小化访问；
尽量使用私有化成员；
注意信息隐藏；
（5）文档与注释；
接口不是只写给自己（即使只给自己，也应该有说明）；
（6）提高性能；
（7）平台无关；

五、类设计
（1）最小易变性；
举例：Date不宜设计成类，过于易变；可设计为TimerTask；
如果可变，则要设计良好、最小化的状态子集合；
（2）尽量少用继承；
如果设计一个类不能被继承，则应该明确禁止；

六、方法设计
（1）不要到处拷贝模板代码；
模块能做的事，不用到处拷贝方法；
（2）原子性应该在一个方法内保证；
（3）Fail-Fast设计原则；
出错尽量早点返回，交给上层处理，不要勉强抢救；
（4）避免数据直接访问，而是提供访问方法；
（5）谨慎重载；
小心多重继承中的误重载；
可以重载的情况，也慎重考虑是否应该重载；
（6）注意参数与返回值类型；
尽量明确类型；
能不用string尽量不用；
使用float的地方尽量用double，64bit；
（7）不改变的参数使用const；
（8）参数个数不宜太多
如果过多，就要考虑接口的合理性了；
（9）避免返回值与异常的同时返回

七、异常设计

八、接口重构
（1）vector中子序列重构；
（2）线程局部变量重构；