很多词语,尤其是动词,可以用于描述同一个操作。但是有的会更表示目的和意图,而有的则更用来体现手段和方式。如:
| 目的或意图 | 手段和方式 |
|---|---|
| enrich | update |
| restrict | filter |
| broadcast | send |
| destroy | delete |
| shutdown | close |
| balance | rotate |
在代码中的不同层次中,词汇的选择也会有不同的倾向。一般而言可以这样划分:
在具体业务相关的代码中,更倾向于使用描述目的和意图的词汇。以便于解释为什么需要做这件事,同时也更容易限定每个方法的边界。
在框架层的代码中,因为一般是与具体业务解耦的,所以根本并不知道,也不应该知道,当前代码被执行时,是为了解决什么样的问题。所以一般使用描述手段和方式的动词。
使用尽量具体的名词,而不要使用过于笼统(注意,笼统不等于抽象,可以使用抽象名词)。
| 具体的 | 笼统的 | 抽象的 |
|---|---|---|
| onFinished | callback | tailMonad |
| filteredItems | list | - |
| AccessHistoryContainer | AccessManager | - |
| upstreamEnityId | reference | sourceId |