PHP Talk 'Refactoring - Improving the Design of Existing Code' Part 5 Simplifying Function Calls_PHP Tutorial

思维导图


介绍

　　前几篇系列文章，我比较关注的是，但是我觉得我还是没有说清楚，我自己也有很多不理解的地方，而且这篇是我的第一篇这方面的文章，有很多的纰漏，所以我会经常性的去做修改，如果大家有好的意见不妨告知一、二。

　　今天谈得是“接口”，此接口非“Interface”，而是一个统称。我们一般可以把供别人使用的函数或者url（一般是用于提供数据）叫接口。——可能还有别的意思，毕竟我现在还属于“菜鸟”，如果有理解上的错误，请指正。

　　我们知道“容易被理解和被使用的接口”，是开发良好面向对象软件的关键。——本文将介绍“使接口变得更简洁易用”的重构手法。

题外话：
　　如果大家觉得我这篇文章太长，看起来麻烦的话，建议大家”就看图片和粗体的文字“。
　　昨天，“old“博友给我留言，我以前也没仔细考虑过，这次我也想了想。留言内容是：

我个人觉得，很多事情只有我们去关注过，才能知道它的价值。
　　至于简单，重构的目地也是为了简单和易理解性。
　　至于执着，我觉得在技术上，我们很多时候需要这种执着，即使你过后觉得你错了，但是我们在这之间还是会有所收获。我们只有经历过很多次的磨合（这种磨合有正确的也有错误的），我们才能知道它的价值，我们才能收获到我们需要的东西。
　　至于利益，”Old“是不是指公司利益，恩，确实是，很多时候我们在编码的过程中，需要赶进度，还有我们在重构中也会有一些错误出来，所以我的建议是，在开发之初，你就要在设计和重构中，不断进行磨合，不要觉得浪费时间，很多时候，好的结构能加速你的开发。

专业术语 Rename Method

状况：如果函数的名称未能揭示函数的用途，那么修改函数名称。

动机：
　　我极力提倡的一种编程风格就是将复杂的处理过程分解成小函数。但是如果小函数的命名不好，这会使你费劲周折却弄不清楚这些小函数各自的用途。

　　给函数命名的一个好办法：考虑应该给这个函数写上一句怎样的注释 -——> 想办法将注释变成函数的名称。

　　起一个好名称并不容易，需要经验。——要想成为一个真正的编程高手，“起名称”的水平至关重要。

　　如果你看到一个函数名称不能很好的表达它的用途，应该马上加以修改。

Example:

Add Parameter

状况：某个函数需要从调用端得到更多的信息，那么为此函数添加一个参数，让该参数带进函数所需信息。

动机：
　　1、Add Parameter 是一个很常用的重构手法。
　　2、修改过的函数需要一些过去没有的信息，因此你需要给函数添加一个参数。
　　3、除了Add Parameter外，只要有可能，其他选择都比“Add Parameter”要好，因为有可能其他选择不会增加参数列的长度。——过长的参数列会使程序员记不住那么多参数。

Remove Parameter

状况：函数本体不再需要某个参数，那么将该参数去除。
动机：
　　1、参数指出函数信息，不同参数代表不同意义。函数调用这必须为每一个参数操心该传什么东西进去。——如果不去掉参数，那就为每一次调用多费一份心。
　　2、如果你发现有很多调用者，那么为了不让调用者操心，你可以这样做，把要移除的参数设置为某个默认值（如null），这样调用者只传那些没有默认值的参数。

Separate Query from Modifier