抽象Api - 需求->Api之间, 文档很重要

很多程序员都特别讨厌"写文档", 听到"写文档"就如"闻虎色变"一样.

但对于想长足发展的"猿"来说, 必须要走进"写文档"的舒适区.

"写文档"对于分析理解业务很重要, 在写文档中可以"抽象Api".

"抽象Api"听起来是很虚的概念, 多写写文档就明白了.

在"分析"并"写文档"的期间, 你会发现某几个Api可以合并在一起; 而另外一些Api合并后, 当业务变更时, 需要修改很多, 而不合并会更好; 顺便还能发现业务的bug.

在著名的《设计模式》一书中，其实在反复强调一点: 发现变化并且封装变化，针对接口编程而不是实现编程, 这是模式的本质。

既然是针对接口编程, 就要把接口设计好. 此接口既包括Api接口, 又包括code中的interface.

看吧, Api文档特别重要吧!!!