Chapter 6 通用情况的模块应该更深

通用情况的模块应该更深

通常我们在设计一个模块的时候都会遇到一个问题，是把它设计的更加通用呢，还是只是解决眼前的问题。
模块设计得更加通用的话会有以下性质：

• 能够解决更多的问题
• 因为很难预料系统以后的需求，因此模块中可能会包含很多从未被用到的功能

在设计类时设计得稍微通用些

模块功能的设计按照当前的需求来进行，但是模块中接口的设计应该设计的通用些，接口的设计不应当和当前的需求耦合

例子：设计一个文本编辑器

目的是设计一个文本编辑器界面，可以打开文件，允许用户修改文本，并且允许在多个窗口中打开同一个文件的视图
首先会设计一个代表文本的类Text，它具有以下几个接口：

void backspace(Cursor cursor);
void delete(Cursor cursor);
void deleteSelection(Selection selection);

其中Cursor代表光标，Selection代表文本范围
然后接着会实现用户接口，这就导致了一个问题，如果这么设计Text类的话，会导致该类中出现很多很浅的接口，每个接口只会在一个用户接口中被用到，比如删除操作，只会在一个地方被用到。开发用户接口的人需要了解大量的Text提供的接口。每添加一个新的用户接口，都需要在Text类中添加相应的接口。所以开发用户接口的人需要同时开发Text接口。

一个更加通用的设计

Text的设计应该更加贴近文本操作的特征，而不应该反映上层的操作，对于修改操作来说，只需要下面两个通用接口：

void insert(Position position, String newText);
void delete(Position start, Position end);

另外使用了Position，而不是反映特定用户的Cursor，另外提供一个改变位置的接口

Position changePosition(Position position, int numChars);

这样删除操作就可以使用如下的代码实现:

text.delete(cursor, text.changePosition(cursor, 1));

虽然这样面向通用性的api的代码相较于面向专用的api的代码更长，但是新代码相较于老的代码更加容易理解；另外在面向未来的新功能时，面向通用性设计的api会用得上，比如现在需要实现一个全局替换功能，如果使用通用性的api，需要的仅是一个搜索文本下一次出现地方的接口

Position findNext(Position start, String string);

通用性设计能够更好地实现信息隐藏

比如在上面这个例子中，如果使用通用性设计，Text类就不需要了解用户接口，比如如何处理退格键，如何处理退格键的逻辑现在在用户接口中

一些在设计中自问的问题

应该设计多少接口来满足现有的需求

如果能够减少接口的数量，但是不减少功能，那么由很大可能是因为设计了更加通用的方法
比如上面的例子，如果是面向专用性的设计，三种删除方式分别需要三个方法，而通用的api只需要一种

看一个方法在多少个地方被用到

如果一个方法只会在一个地方被调用，可能意味着该方法过于专用化

当前的api对于当前的需求来说是否易于使用

这个问题可以用来判断接口的通用性是否过大。比如如果将删除操作和添加操作都设计为只能删除一个字符，这样的接口虽然也很简单并且具有通用性，但是不利于使用，用户接口需要调用循环来执行多次删除或者添加