refactoring Patterns（七）:场合与命名规则

一起学习

虽然refactoring几乎可以随时进行，然而，按照我们关于两顶帽子的原则，在某些场合下 ，refactoring的介入显得更加实际、有意义、富有成效。 另外，在最后进入Refactoring实践之前，我把Kent Beck和Martin Fowler给我们的忠告和建议放在这里。这些内容，特别是Code Smell和命名规则不但对我们进行refactoring具有很强的实践意义。同时，他们也促使我们对很多OO设计和编码的原则进行更多的思考。 Refactoring 应用的场合 增加功能 如果你的代码不需要增加新的功能，那么你几乎没有必要对他进行Refactoring。增加功能是进行Refactoring最常见的起因。通常，refactoring的第一个目标就是为了让代码更容易理解。Refactoring不仅仅可以使难以理解的代码更加清晰，他也可以使你对它的理解呈现一种交互状态，你和代码的交互。理解了，新的功能就很容易加入。 另一个原因是原来代码的结构很难直接扩展，可能是因为一个类和另外一个类的绑定太紧，或者是他使用了大量的case语句，或者是有一些重复的代码让你觉得加入你的代码会使结构更差。总而言之，直接加入新功能不是太方便。这时候，你就需要Refactoring，使得旧的代码在能让旧的test case通过的情况下，让新的代码加入更加方便、快捷。 重用 重用可以说是增加功能的一个特例。因为这是OO增加功能最主要的方法。但这里有一些差别。 如果你的代码是一个框架，那么当把代码交给其他人使用时，你必须重点考虑框架的重用方法。譬如，你想在框架之上增加一层facade，这时候，你可能需要refactoring一些内部类，让这个Facade的结构更容易加入。 对框架Refactoring可能需要是一个反馈的过程。因为框架一旦稳定就可能长期存在，一般你不会直接对这个框架增加功能。这时，不同应用程序对框架使用经验的积累可能使得你的Refactoring具有更加明确的目标，更加深层次的抽象。 修正bug bug产生的原因有很多。可能是你对解决的问题理解不够，也可能是程序的代码过于纷乱。当你的代码结构不是很清晰时，bug往往隐藏在代码之中，使你很难发现。应用Refactoring让代码结构结构更清晰的同时，也使得bug自动浮出水面。 Refactoring所追求的目标和过程往往使得代码的Bug无处遁形。Eric E. Allen在IBM中developerWorks的bug pattern中的一个模式就是copy-and-paste方法造成代码重复，从而产生bug的一个例子。这个 Rogue Title Pattern是一个非常常见的bug例子，当你修正了程序中一个bug时，你发现程序运行的结果是你明明已经修正的bug还在作怪。究其原因，就是程序员在实现一个功能的时候把一段代码复制过去，稍加修改，就成为一个新的函数。你修改了一个地方，但却忘了另外一个地方。 Refactoring力求排除重复代码，如果有这样的bug，在refactoring以后，一次修改就能纠正所有的问题。 Code Review Review可以使得专家知识传播到整个开发队伍。他们能够帮助更多的人理解一个大系统更多方面的问题。它们对于编写清晰的代码也有很好的帮助。俗话说得好，三个臭皮匠顶一个诸葛亮，Review也使得你能够接受更多其他人的好意见和想法，从而使你的设计和代码更加合理。 按照Martin Fowler的建议，我使用refactoring作为我的主要review方法。我有比较多的机会做这样的Code Review，在程序员发现一个难以解决的bug，或者当他们觉得自己的思路无法进行下去的时候，他们通常会要求我的帮助。 我的方法通常是问几个简单的问题，然后直接找到他们的代码，进行refactoring，在这个过程中，我总是一边refactoring，一边和程序员讲解我这样做的意图。令人惊奇的是，一旦我这样去做，程序员往往能够在我refactoring的过程中自己发现问题。由于Refactoring的结果非常具体，我很容易对程序员讲述一些本来就可以直接这样实现的例子，这对提高程序员的编程能力有极大的帮助。 味道 Kent Beck的" Code Smell"或许是OO社团最有人情味的名言了。Martin Fowler和Kent Beck专门合著了《Refactoring》其中的一章就叫《Bad Smells in Code》。 虽然对Refactoring的研究涉及到了形式化地探测代码的结构，譬如专门的重复代码监测工具。但这些研究尚处于幼年期。更何况，很多代码的结构并不是能够用简单的数字统计和抽象语法树所能解决的。 Code Smell是高水平的程序员对代码的一种感觉，当你能够闻到这样的味道时，你就可以在不涉及到程序所要解决的具体问题时，就"闻到"代码结构的好坏。 Kent Beck 和Martin Fowler列出的代码味道有： Duplicated Code 代码重复几乎是最常见的异味了。他也是Refactoring的主要目标之一。代码重复往往来自于copy-and-paste的编程风格。与他相对应OAOO是一个好系统的重要标志（请参见我的duplicated code一文）。 Long method 它是传统结构化的"遗毒"。一个方法应当具有自我独立的意图，不要把几个意图放在一起，我的《大类和长方法》一文中有详细描述。 Large Class 大类就是你把太多的责任交给了一个类。这里的规则是One Class One Responsibility。参见我的《大类和长方法》。 Divergent Change 一个类里面的内容变化率不同。某些状态一个小时变一次，某些则几个月一年才变一次；某些状态因为这方面的原因发生变化，而另一些则因为其他方面的原因变一次。 面向对象的抽象就是把相对不变的和相对变化相隔离。把问题变化的一方面和另一方面相隔离。这使得这些相对不变的可以重用。问题变化的每个方面都可以单独重用。这种相异变化的共存使得重用非常困难。 Shotgun Surgery 这正好和上面相反。对系统一个地方的改变涉及到其他许多地方的相关改变。这些变化率和变化内容相似的状态和行为通常应当放在同一个类中。 Feature Envy 对象的目的就是封装状态以及与这些状态紧密相关的行为。如果一个类的方法频繁用get方法存取其他类的状态进行计算，那么你要考虑把行为移到涉及状态数目最多的那个类。 Data Clumps 某些数据通常像孩子一样成群玩耍：一起出现在很多类的成员变量中，一起出现在许多方法的参数中… ，这些数据或许应该自己独立形成对象。 Primitive Obsession 面向对象的新手通常习惯使用几个原始类型的数据来表示一个概念。譬如对于范围，他们会使用两个数字。对于Money，他们会用一个浮点数来表示。因为你没有使用对象来表达问题中存在的概念，这使得代码变的难以理解，解决问题的难度大大增加。好的习惯是扩充语言所能提供原始类型，用小对象来表示范围、金额、转化率、邮政编码等等。 Switch Statement 基于常量的开关语句是OO的大敌，你应当把他变为子类、state或strategy。 Parallel Inheritance Hierarchies 并行的继承层次是shotgun surgery的特殊情况。因为当你改变一个层次中的某一个类时，你必须同时改变另外一个层次的并行子类。 Lazy Class 一个干活不多的类。类的维护需要额外的开销，如果一个类承担了太少的责任，应当消除它。 Speculative Generality 一个类实现了从未用到的功能和通用性。通常这样的类或方法唯一的用户是test case。不要犹豫，删除它。 Temporary Field 一个对象的属性可能只在某些情况下才有意义。这样的代码将难以理解。专门建立一个对象来持有这样的孤儿属性，把只和他相关的行为移到该类。最常见的是一个特定的算法需要某些只有该算法才有用的变量。 Message Chain 消息链发生于当一个客户向一个对象要求另一个对象，然后客户又向这另一对象要求另一个对象，再向这另一个对象要求另一个对象，如此如此。这时，你需要隐藏分派。 Middle Man 对象的基本特性之一就是封装，而你经常会通过分派去实现封装。但是这一步不能走得太远，如果你发现一个类接口的一大半方法都在做分派，你可能需要移去这个中间人。 Inappropriate Intimacy 某些类相互之间太亲密，它们花费了太多的时间去砖研别人的私有部分。对人类而言，我们也许不应该太假正经，但我们应当让自己的类严格遵守禁欲主义。 Alternative Classes with Different Interfaces 做相同事情的方法有不同的函数signature，一致把它们往类层次上移，直至协议一致。 Incomplete Library Class 要建立一个好的类库非常困难。我们大量的程序工作都基于类库实现。然而，如此广泛而又相异的目标对库构建者提出了苛刻的要求。库构建者也不是万能的。有时候我们会发现库类无法实现我们需要的功能。而直接对库类的修改有非常困难。这时候就需要用各种手段进行Refactoring。 Data Class 对象包括状态和行为。如果一个类只有状态没有行为，那么肯定有什么地方出问题了。 Refused Bequest 超类传下来很多行为和状态，而子类只是用了其中的很小一部分。这通常意味着你的类层次有问题。 Comments 经常觉得要写很多注释表示你的代码难以理解。如果这种感觉太多，表示你需要Refactoring。 Refactoring和命名 Refactoring使代码更容易理解的最有效和常用的手段之一就是给类、方法和属性一个恰如其分的名字。很多公司和个人都编出了大量的代码命名规范。如果这些规范太繁琐，那就无法执行。有好的命名规则是好事，但并不总是如此。最重要的是，在整个项目开发团队内，必须保持一致的命名规则，也许不是世界上最好的，但却是对该项目最好的。下面一些是Refactoring中一些有效的命名原则： 类命名 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。(传达你要做什么（接口）而不是你如何做（实现）) 实例（临时）变量命名-暗示角色 任何实例变量传达的信息包括两部分： 什么是它的目的？ 它如何被使用？ 一个变量的目的或者说它担当的角色对读者非常重要，因为它能够正确地引导读者的注意力。一般，你在阅读代码时脑袋里总有一个目的。如果你理解变量的角色，而这个角色和你的目的无关，那么你可以直接跳过使用该变量的无关代码。如果发现该变量的角色和你的目的有关，那么你就能马上缩小你的阅读范围-那些引用此变量的相关代码。 一个变量如何被使用和发送给它什么消息通常是它的"类型"。理解类型并非不重要。但是，对于实例变量来说，你能够了解这个变量所担当角色的唯一地方就是它的名字。如果一个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。 （用计算中实例变量所承担的角色对它命名。如果变量持有一个集合，使用复数。） 参考书目 Martin Fowler : 《Refactoring：Improving the design of existing Code》 Kent Beck：《Extreme Programming Explained》 Kent Beck：《Smalltalk Best Practice Pattern》 William C. Wake: 《Extreme Programming Explored》 Jeff Langr： 《Evolution of Test and Code Via Test-First Design》 Robert C. Martin: 《An Extreme Programming Episode》 Don Robert，John Brant and Ralph Johnson:《A Refactoring Tool for Smalltalk》 Jrefactory： jrefactory.Sourceforge.net Gamma , Junit: Refactoring Browser: GOF：《Design Patterns: Elements of Reusable Object Oriented Software》 MartinFowler :《UML distilled》 Braint Foote and Joseph Yoder：《Big Ball of Mud》 William Opdyke Ph.D. Thesis：《Refactoring Object-Oriented Frameworks》 Braint Foote and William Opdyke:《Life Cycle and Refactoring Patterns that Support Evolution and Reuse》 Mel O Cinneide：Ph.D. :《Automated Application of Design Patterns: a Refactoring Approach》 Donald Bradley Roberts: Ph.D.:《Practical Analysis for Refactoring》 C2： Eric Gamma, Kent Beck: Junit: Lance Tokuda:《Evolving Object-Oriented Designs with Refactoring》 Michael Hunger：《Refactoring：Benefits and Disadvantages》 TOMCAT BOOK Shiyiying：Code Smell serials William F. Opdyke,Object-Oriented Refactoring，Legacy Constraints and Reuse Stephen R.Schach:《Classical and Object-Oriented Software Engineering》 Christopher Alexander：《The Timeless Way of Building》 关于作者 石一楹，现任浙江大学灵峰科技开发公司技术总监。多年从事OO系统分析、设计。现主要研究方向为Refactoring和分析模式。你可以通过[e-mail]和我联系。

 

代码太容易变坏，重复代码随处可见，特别是那些初看相似细看又不同的

代码泛滥于整个系统：

条件表达式，循环结构、集合枚举.....信息被共享于系统一些关系甚少的

组成部分之间，通常，这使得系统中几乎所有的重要信息都变成全局或者重复。

解决这个问题的最好办法当然是让它不要发生。然而，要阻止代码的腐化，

你需要付出额外的代价。每次在修改或增加代码之前，你都要看一看手上的这些代码。

如果它很好的话，那么你应该能够很方便地加入新的功能。如果你需要花很长的时间

去理解原来的代码，花更长的时间去增加和修改代码。

那么，先放下手里的活，让我们来做 Refactoring。 



一.Refactoring 介绍 

二.Refactoring 理由 

三.Refactoring 问题 

四.Refactoring 困难 

五.Refactoring 方法 

六.Refactoring 与软件设计 

七.Refactoring 场合与命名规则 



中文JAVA技术网重新整理发布

下载本文示例代码


refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则refactoring Patterns（七）:场合与命名规则