第85页 4.1 封装和最佳模块大小

模块化代码的首要特质就是封装。封装良好的模块不会过多向外部披露自身的细节，不会直接调用其他模块的实现代码，也不会胡乱共享全局数据。模块之间通过应用程序变成接口（API）——一组严密、定义良好的程序调用和数据结构来通信。这就是模块化原则的内容。
有一种很好的方式来验证API是否设计良好：如果是这用纯人类语言描述设计（不许摘录任何源代码），能否把事情说清楚？养成在编码前为API编写一段非正式书面描述的习惯，是一个非常好的办法。实际上，一些最有能力的开发者，一开始总是定义接口，然后编写解药的注释，对其进行描述，最后才编写代码——因为编写注释的过程就是阐明了代码必须要到的目的。这种描述能够帮助你组织思路，本身就是十分有用的模块说明，而且，最终要可能还想把这些说明做成路标文档，方便以后的人阅读代码。