image.png

本文源自Google工程师joshua bloch的经验分享,楼主进行了整理和总结。

一、好接口的特性

(1)易学

(2)易用,甚至不需要文档

(3)难于误用

(4)容易阅读与维护

(5)容易扩展

二、接口设计实现的过程

(1)分析需求

考虑是否有更佳解决方案?

这是否使我们这真想要的需求?

(2)设计小接口

这个阶段,快速敏捷迭代

小接口易于修改

小接口的实现给人自信,减少挫败感

(3)高频、提早撰写接口

实现自测用例

(4)撰写服务提供接口(SPI:service provider interface)尤为重要

如果提供一个接口,是否就不支持第二个?

如果提供两个接口,是否能够扩展,融合?

如果提供三个接口,是否足够?能否工作正常?

(5)注意“正常的”异常维护

你的接口是为了满足所有需求?

即使有异常,也不要紧

三、接口设计的基本原则

(1)只做并做好一件事

函数名自解释;

收藏 打印