类命名
Kent Beck 提出其中大多数的规则。Kent Beck 的《Smalltalk Best Practice Pattern》是我
至今为止读过的所有书里面最符合我审美观点的书籍?渊博的知识和春秋的笔法。
简单超类名?传达设计目的
命名总要受各种因素的影响。你想把名字取得尽量短，易于输入、格式化、容易说出口。
同时，你也想让名字尽可能包含更多的信息，这样读者就能够更快地理解名字所包含的实际
内容。你可能取一些尽量为人所熟悉的名字，这样在名字中就能传递更多的一起经验。同
时，你也想让名字尽量唯一，别人的代码命名就不会和你重复。
Kent Beck 给出的第一个规则就是不要缩写。缩写对输入（20 年内10-100 次）的考虑
多余对理解（20 年内1000-10000 次）的考虑。理解缩写词需要两步，第一步理解这些缩写
代表的词语，第二步采取理解这些词语所代表的意义。
对一个大层次的根类命名是个重大的决策。在未来的20 年中，人们可能不断地使用
你所给出的名字。你必须不犯错误。
人们通常在命名超类时加上各种各样的修饰，富有计算机科学意义、给人深刻印象但最
终却没有意义的单词，如Object，Thing，Component，Part，Manager，Entity 或Item。
你在创建一个词汇表，而不是写一个程式。暂时做一回诗人。简单、生气勃勃、容易记
忆远远比说出全部内容更有效。规则：
Name a superclass with a single word that conveys its purpose in the design。
（用一个单词命名超类，传达他的设计目的），好的例子包括：
Number 、Collection、Magnitude、Model
全称子类名?区分异同
命名类的一种方法是给一个唯一的名字。唯一的名字能让你用用最短的信息表达最多
的信息。
这对于通用术语来说是对的。Array 是Collection 的一个子类，因为绝大多数人都知道
“Array“意味着什么。
但在绝大多数情况下，类继承的层次结构对于理解你的代码十分重要，特别是个子类
概念上是超类的变种同时又和超类共享实现的情况。你需要传递两部分信息：
1．新类怎么相同，及
2．新类怎么不同
要表达相同，你能借用超类的名字。这不一定是个直接的子类和父类关系，层次上
有一定距离也无妨。要表达不同，你需要一个单词确切地强调新类为什么不是超类的理由。
所以，有规则：
Name subclasses in your hierarchies by prepending on an adjective to the superclass
name。
（在超类名字前加上内容命名你层次中的子类。）
例子：
BigInteger 是个能表达非常大非常大数字的整数。
方法命名?揭示意图
为什么好的代码总有非常多简单的方法，代码可能只有一行，譬如：
class ParagraphEditor。。。。
public void highlight
（aRectangle:Rectangle）{
reverse(aRectangle);
文件名的命名规则}
这个highlight 只是分派到reverse，为什么还需要？
关键在于Communication。因为有了这个方法，以后的代码就能用highlight 来说话。
我要加亮一个区域，我就highlight 他。
你当然能直接使用reverse，结果是相同的。但所有调用代码都揭示了实现?“我通
过反转一个矩形来加亮他“。
代码应当揭示意图，他另外的好处是能更方便通过继承修整。如果你想要一个
ParagraphEditor 用颜加亮，那么只需继承ParagraphEditor 并覆盖highlight 即可。所以：
communicate what is to be done rather than how it is to be done。
传达你要做什么（接口）而不是你怎么做（实现）。
实例（临时）变量命名?暗示角
所有实例变量传达的信息包括两部分：
1．什么是他的目的？
2．他怎么被使用？
一个变量的目的或说他担当的角对读者非常重要，因为他能够正确地引导读者的注
意力。一般，你在阅读代码时脑袋里总有一个目的。如果你理解变量的角，而这个角和
你的目的无关，那么你能直接跳过使用该变量的无关代码。如果发现该变量的角和你的
目的有关，那么你就能马上缩小你的阅读范围?那些引用此变量的相关代码。
一个变量怎么被使用和发送给他什么消息通常是他的“类型“。理解类型并非不重要。
不过，对于实例变量来说，你能够了解这个变量所担当角的唯一地方就是他的名字。如果
一个Point 中有两个实例变量叫做int1、int2 而并非x、y，那么在你理解哪一个是横向坐标，
哪一个是纵向坐标前，你可能要都上一堆代码。更何况你还要阅读和之相关的非常多代码。而
变量的类型非常容易从他声明、传递给他的消息看出来。所以：
Name instance variable for the role they play in the computation。Make the name plural
if the variable will hold a Collection。
（用计算中实例变量所承担的角对他命名。如果变量持有一个集合，使用复数。）
版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。
发表评论