【读书笔记】-《重构-改善既有代码的设计》

序言:

        断断续续又是一周,想想为什么写这些笔记,其实也是自己偷懒的表现。懒得过来一个月后再去翻这本书发现又是一本新书重头看到尾,偷懒到随时翻看笔记就可以回忆起某些重点就足以;另外一个原因也是为了激励自己,每每看完一本书总得留下点什么,觉得有用或者无用,也是对自己的一个监督。很多时候,通往成功的路,往往在0到1之间放弃了坚持,只有跨越了01坎,往往就可以发现新大陆。

《重构-改善既有代码的设计》

        一眼看到这本书的书的时候,给我的感觉就是:重构,一定是非常大的一个项目,或者至少是代码量很多的工程才会用到重构这些项技术,很多时候是不需要的。当自己实际深入的钻入书本,体会作者的良苦用心时,才枉然大悟。原来重构镶嵌在我们开发工程中的每个空隙,一不小心我们就涉及到。所以书中的对重构的定义是:重构是不改变软件可观察行为的前提下改善其内部结构。另外的一种说法是:对软件内部结构的一种调整,目的是不改变软件可观察行为的前提下,提高其可理解性,降低其修改成本。

因为书中是以java为例子,大部分偏向于面向对象。我对c++、Java也是略微的了解,对python更加熟悉,所以书中提及类的封装,接口的优化与开发的概念还是可以理解到作者的良苦用心。其实对于我现在常用到的方法做个总结,目前的工作还基本上是以C为主。

        其实在重构之前,为什么要重构的问题,书中也明确的提及,比如第三章-代码的坏味道。标题就总结的很好,比如说:重复代码、过长函数、过大的类、过长的参数、发散式变化、散弹式变化、依恋情节、数据泥潭、基本类型偏执、Switch惊悚现身、平行继承体系、冗赘类、夸夸其谈未来性、令人迷惑的暂时字段、过度耦合的消息链、中间人、狎昵关系、异曲同工的类、不完美的库类、纯稚的数据类、被拒绝的遗赠、过多的注释。仅仅是这些标题,马上就可以结合实际工作中遇到的的这些编码雷区。只有知道什么是雷区,才能在实际的编程中避免。有一位有经验的工程师曾说过:新手程序员为有经验的程序员对比,为什么有经验的程序员可以编写稳定的框架,不是因为没有bug,而是在实际开发中,有经验的程序员能很明确知道哪些是坑,然后跳过或者费很大劲去绕过;但是新手程序员可能就会扎根进去,结果却不得而知。所以在实际的开发中,知道哪些是雷区,哪些是坑,事先绕过,才能减少抓虫子的时间。

        但是如果已经入雷区入坑了怎么办?也许重构是一种方法,但是对于一个不是很了解程序的老板来说,很多只是关心结果,不可能说我不实现新功能了,我要花一个星期去重构代码。如果一个系统真正的遇到瓶颈了,真的需要重构,到那种地步的话,就需要顾问已经专业的有经验的带头人去进行重构整个系统,就好比一个sdk的升级板。在上一东家的工作中,很庆幸我能参与SDK平台开发。在开发之前,就一个旧版本的SDK,但是为了添加新功能,方便二次开发等因素,但是核心功能不变的原则,使用python开发。虽然接口已经变,但是方向是明确的,以至于我在职的时候,还进行了下一版本的开发,虽然还没有上线,我就被安排到测试组兼任leader,也是之前博文所写的。回归正题,就因为之前没有沉淀,现在看到这些熟悉的方法,就是曾相识,所以,如何进行重构,我就书中提及的方法中,总结一些我将来工作会用到的方法:

  • Extract Method(提炼函数)

        这个方法几乎都适用,目标很明确。每个函数应该有它单一的功能,不要杂糅着各种各样的功能,相互依赖的变量关系在里面。

  • Replace Temp With Query(以查询取代临时变量)

        我们都希望写出一个简洁的代码,并且不却功能的函数。那么变量会在函数中经常发现。这个方法的前提是,如果该函数中为了存储调用函数的返回值,并且只是为了做个安全的判断,那么这样的情况就可以省略掉该变量,而直接使用查询函数代替变量;但是如果该变量被使用的次数为2次以上,那么就可以暂时的预留吧。

  • Remove Assignments to Parameters(移除对参数的赋值)

        对参数的赋值是比较危险的一个操作,如果传入的是个指针,如果在函数中将这个地址用作其他临时变量赋值,那么这就入坑了。所以我们需要引入一个局部变量来存这个参数。也就是说:在按值传递的情况下,对参数的任务修改,都不会对调用造成任何影响。

  • Rename Method(函数改名)

        函数的名称应该准确表达它的用途。给函数命名的一个好方法:首先考虑应该给这个函数写上一个怎样的注释,然后想办法将注释变成函数名称。

        我们常常无法第一时间就给函数起一个很好的名称。这时候我们就可能会这样将就着,但是,这是通向混乱之路。这在前面的书籍《程序员修炼之道》中也有提及过。如果看到一个函数名称不能很好的表达它的用途,应该马上加以修改。记住,我们的代码是为人写的,其次才是为计算机写的。

  • Remove Parameter(移除参数)

        程序员可能经常添加参数,却常常不愿意去掉它们。他们打的如意算盘是:无论如何,多余的参数不会引起问题,而且以后还可能用上它,并且如果修改可能还会有意外的虫子进来。

        这也是通往混乱之路。参数代表着函数所需的信息,不同的参数值有着不同的意义。函数调用者必须为每一个参数操心该传什么东西进去。如果不去掉多余的参数,就是让你的每一个用户或者代码维护者多费一份心。是很不划算,更何况“去除参数”是非常简单的的一项重构,只要保证测试的完整与准确性,就可放心的做。

  • Separate Query from Modifier(将查询函数与修改函数分离)

也就是说,某个函数即返回对象值,也修改了状态,这样的函数就需要去重构,就应该将两个功能函数分开实现。

  • Parameterize Method(令函数携带参数)

若干函数做了类似的工作,但是函数本体中却包含了不同的值。这样的情况下,我们就可以考虑使用这样的方法,其实就是消除重复代码。

        我只是大概总结了一些常用的方法,有些很简单,但是却很实用。其实在阅读的过程中或者在看标题的时候,会发现,咦,有些说法是不是有些矛盾了,这里说需要去除参数,那里说需要添加参数。当我完全看完的时候,才理解其中的奥秘。重构,不是我们所想的那么简单,也不是我们不能高攀的那么困难。仅仅知道这些方法是不够的,也不是强拖拽的一定将某个方法用上或者把全部方法用个遍,其实不是。我们知道这些方法,知道哪些是代码的坏味道,才会在实际的编程中刻意的规避它,不让自己入坑。虽然都说编程就是不断挖坑不断填坑的过程,自己挖的还好,如果是别人挖的,那可真的有可能深不见底。所以,你入或不入,坑就在那里,不来不去;而我们手持秘籍,遇坑则避,乃智人也!

  • 测试

        所以,最后,再谈谈测试。在阅读了前面的几本书后,比如《软件测试的艺术》、《程序员的思维修炼》、《程序员的修炼之道》都会提及测试,可见测试在整个系统中乃至开发过程中的地位之重。就重构而言,为什么使用测试,为什么要保证测试。书中的理由也是让人很信服的。以下是书中原话,还是很想将作者的心声记录下来,因为他说的就是我们的心声:

        如果认真观察程序员把最多的时间耗在哪里,你就会发现,编写代码其实只是占非常小的一部分。有些时间用来决定下一步干什么,另一些时间花在设计上,最多时间则是用来调试。我敢肯定每一位读者都还记得自己花在调试上的数个小时无数次的通宵达旦。修复错误通常是比较快的,但是错误却是一场噩梦。当你修好一个错误,总是会有另一个错误出现,而且肯定要很久后才会注意到它。那是你又花上大把时间去寻找它。

        “自测试代码”--类应该包含它们自己的测试代码。作者是这样理解的:每个类都该有一个测试函数,并以它来测试自己这个类。

        所以作者就开始在自己开发的代码中添加测试函数,并且可以运行。后面发现更加有趣的事情,就是这样测试函数可以单独运行,再配合一些脚本及控制台,就可以做出自动化测试效果--确保所有测试都完全自动化,让它们检查自己的测试结果。

        当然,说服别人也这样做并不容易。编写测试程序,意味着要写很多额外的代码。除非你确切体会到这种方法对编程速度的提升,否则自我测试就显不出它的意义。很多人根本没学过如何编写测试程序,甚至根本没有考虑过测试,对于编写自我测试代码也很不利。如果需要手动运行测试,那更是令人烦闷;但如果可以自动运行,编写测试代码就真的很有趣。

        其实现在想要编写测试代码,很多语言就有第三方库的支持。具体原理都差不多,模拟对象,模拟变量,预测结果。在《软件测试的艺术中有详细的讲解》。

        那么,我们为什么在说重构的时候要使用测试,而且还是比较完善的测试体系。用途就在于:如果在重构过程中,自认为已经重构完成,但是如何去检验功能是否还在,那么这时候就需要在重构过程中经常运行测试,只要有一项测试不通过,那么就是说您的重构的函数可能缺胳膊短腿了,需要注意了,需要去修复它。只有这样步步为营,才能将重构安全的进行下去,否则就是灾难性的毁灭,那么经理绝对不会开心的。

 

 

第1章 重构,第一个案例 1 1.1 起点 1 1.2 重构的第一步 7 1.3 分解并重组statement() 8 1.4 运用多态取代与价格相关的条件逻辑 34 1.5 结语 52 第2章 重构原则 53 2.1 何谓重构 53 2.2 为何重构 55 2.3 何时重构 57 2.4 怎么对经理说 60 2.5 重构的难题 62 2.6 重构设计 66 2.7 重构与性能 69 2.8 重构起源何处 71 第3章 代码的坏味道 75 3.1 Duplicated Code(重复代码) 76 3.2 Long Method(过长函数) 76 3.3 Large Class(过大的类) 78 3.4 Long Parameter List(过长参数列) 78 3.5 Divergent Change(发散式变化) 79 3.6 Shotgun Surgery(霰弹式修改) 80 3.7 Feature Envy(依恋情结) 80 3.8 Data Clumps(数据泥团) 81 3.9 Primitive Obsession(基本类型偏执) 81 3.10 Switch Statements(switch惊悚现身) 82 3.11 Parallel InheritanceHierarchies(平行继承体系) 83 3.12 Lazy Class(冗赘类) 83 3.13 Speculative Generality(夸夸其谈未来性) 83 3.14 Temporary Field(令人迷惑的暂时字段) 84 3.15 Message Chains(过度耦合的消息链) 84 3.16 Middle Man(中间人) 85 3.17 Inappropriate Intimacy(狎昵关系) 85 3.18 Alternative Classes with Different Interfaces(异曲同工的类) 85 3.19 Incomplete Library Class(不完美的库类) 86 3.20 Data Class(纯稚的数据类) 86 3.21 Refused Bequest(被拒绝的遗赠) 87 3.22 Comments(过多的注释) 87 第4章 构筑测试体系 89 4.1 自测试代码的价值 89 4.2 JUnit测试框架 91 4.3 添加更多测试 97 第5章 重构列表 103 5.1 重构的记录格式 103 5.2 寻找引用点 105 5.3 这些重构手法有多成熟 106 第6章 重新组织函数 109 6.1 Extract Method(提炼函数) 110 6.2 Inline Method(内联函数) 117 6.3 Inline Temp(内联临时变量) 119 6.4 Replace Temp with Query(以查询取代临时变量) 120 6.5 Introduce Explaining Variable(引入解释性变量) 124 6.6 Split Temporary Variable(分解临时变量) 128 6.7 Remove Assignments to Parameters(移除对参数的赋值) 131 6.8 Replace Method with Method Object(以函数对象取代函数) 135 6.9 Substitute Algorithm(替换算法) 139 第7章 在对象之间搬移特性 141 7.1 Move Method(搬移函数) 142 7.2 Move Field(搬移字段) 146 7.3 Extract Class(提炼类) 149 7.4 Inline Class(将类内联化) 154 7.5 Hide Delegate(隐藏“委托关系”) 157 7.6 Remove Middle Man(移除中间人) 160 7.7 Introduce Foreign Method(引入外加函数) 162 7.8 Introduce Local Extension(引入本地扩展) 164 第8章 重新组织数据 169 8.1 Self Encapsulate Field(自封装字段) 171 8.2 Replace Data Value with Object(以对象取代数据值) 175 8.3 Change Value to Reference(将值对象改为引用对象) 179 8.4 Change Reference to Value(将引用对象改为值对象) 183 8.5 Replace Array with Object(以对象取代数组) 186 8.6 Duplicate Observed Data(复制“被监视数据”) 189 8.7 Change Unidirectional Association to Bidirectional(将单向关联改为双向关联) 197 8.8 Change Bidirectional Association to Unidirectional(将双向关联改为单向关联) 200 8.9 Replace Magic Number with Symbolic Constant(以字面常量取代魔法数) 204 8.10 Encapsulate Field(封装字段) 206 8.11 Encapsulate Collection(封装集合) 208 8.12 Replace Record with Data Class(以数据类取代记录) 217 8.13 Replace Type Code with Class(以类取代类型码) 218 8.14 Replace Type Code with Subclasses(以子类取代类型码) 223 8.15 Replace Type Code with State/Strategy(以State/Strategy取代类型码) 227 8.16 Replace Subclass with Fields(以字段取代子类) 232 第9章 简化条件表达式 237 9.1 Decompose Conditional(分解条件表达式) 238 9.2 Consolidate Conditional Expression(合并条件表达式) 240 9.3 Consolidate Duplicate Conditional Fragments(合并重复的条件片段) 243 9.4 Remove Control Flag(移除控制标记) 245 9.5 Replace Nested Conditional with Guard Clauses(以卫语句取代嵌套条件表达式) 250 9.6 Replace Conditional with Polymorphism(以多态取代条件表达式) 255 9.7 Introduce Null Object(引入Null对象) 260 9.8 Introduce Assertion(引入断言) 267 第10章 简化函数调用 271 10.1 Rename Method(函数改名) 273 10.2 Add Parameter(添加参数) 275 10.3 Remove Parameter(移除参数) 277 10.4 Separate Query from Modifier(将查询函数和修改函数分离) 279 10.5 Parameterize Method(令函数携带参数) 283 10.6 Replace Parameter with Explicit Methods(以明确函数取代参数) 285 10.7 Preserve Whole Object(保持对象完整) 288 10.8 Replace Parameter with Methods(以函数取代参数) 292 10.9 Introduce Parameter Object(引入参数对象) 295 10.10 Remove Setting Method(移除设值函数) 300 10.11 Hide Method(隐藏函数) 303 10.12 Replace Constructor with Factory Method(以工厂函数取代构造函数) 304 10.13 Encapsulate Downcast(封装向下转型) 308 10.14 Replace Error Code with Exception(以异常取代错误码) 310 10.15 Replace Exception with Test(以测试取代异常) 315 第11章 处理概括关系 319 11.1 Pull Up Field(字段上移) 320 11.2 Pull Up Method(函数上移) 322 11.3 Pull Up Constructor Body(构造函数本体上移) 325 11.4 Push Down Method(函数下移) 328 11.5 Push Down Field(字段下移) 329 11.6 Extract Subclass(提炼子类) 330 11.7 Extract Superclass(提炼超类) 336 11.8 Extract Interface(提炼接口) 341 11.9 Collapse Hierarchy(折叠继承体系) 344 11.10 Form Tem Plate Method(塑造模板函数) 345 11.11 Replace Inheritance with Delegation(以委托取代继承) 352 11.12 Replace Delegation with Inheritance(以继承取代委托) 355 第12章 大型重构 359 12.1 Tease Apart Inheritance(梳理并分解继承体系) 362 12.2 Convert Procedural Design to Objects(将过程化设计转化为对象设计) 368 12.3 Separate Domain from Presentation(将领域和表述/显示分离) 370 12.4 Extract Hierarchy(提炼继承体系) 375 第13章 重构,复用与现实 379 13.1 现实的检验 380 13.2 为什么开发者不愿意重构他们的程序 381 13.3 再论现实的检验 394 13.4 重构的资源和参考资料 394 13.5 从重构联想到软件复用和技术传播 395 13.6 小结 397 13.7 参考文献 397 第14章 重构工具 401 14.1 使用工具进行重构 401 14.2 重构工具的技术标准 403 14.3 重构工具的实用标准 405 14.4 小结 407 第15章 总结 409
一直很喜欢重构这本书,但是由于自己记性不太好,书看过之后其中的方法总是记不住,于是想如果有电子版的重构书就好了,工作中遇到重构的问题可以随时打开查阅。在网上搜索了许久,发现重构这本书有英文chm版本的,而中文版的电子书只有扫描的PDF版本,用起来非常不方便。于是萌生想做一本重构工具书的想法,本来打算自己重新将重构书的内容再整理归类一下,后来发现原书的目录编排就很适合做工具书,包括坏味道分类,重构手法归类等,都有了一个比较系统的整理。因此,我利用空余时间制作了这样的一本中文的chm版重构,希望对大家有所帮助,也算对中国软件业做出一点小小的贡献。 本书基本上是取自”重构”中文版一书的内容,但格式上参照的是chm英文版的格式,还有一些格式小修改,比如第一章的重构前后代码对比。因为时间匆促,个人能力有限,本书难免存在一些缺漏,如果大家发现有问题,随时可以给我发邮件,我会尽快更新错误的内容。 最后再次感谢几位大师 Martin Fowler、Kent Beck等,还有翻译的侯捷和熊节先生,为我们带来这么精彩的一本书。谢谢。 免责声明:本书仅供个人学习研究之用,不得用于任何商业目的,不得以任何方式修改本作品,基于此产生的法律责任本人不承担任何连带责任。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值