PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用


Posted in PHP onMay 07, 2012

思维导图
PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

介绍

前几篇系列文章,我比较关注的是<PHP 杂谈《重构-改善既有代码的设计》之一 重新组织你的函数>,但是我觉得我还是没有说清楚,我自己也有很多不理解的地方,而且这篇是我的第一篇这方面的文章,有很多的纰漏,所以我会经常性的去做修改,如果大家有好的意见不妨告知一、二。

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

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

题外话:

如果大家觉得我这篇文章太长,看起来麻烦的话,建议大家”就看图片和粗体的文字“。

昨天,“old“博友给我留言,我以前也没仔细考虑过,这次我也想了想。留言内容是:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

我个人觉得,很多事情只有我们去关注过,才能知道它的价值。

至于简单,重构的目地也是为了简单和易理解性。

至于执着,我觉得在技术上,我们很多时候需要这种执着,即使你过后觉得你错了,但是我们在这之间还是会有所收获。我们只有经历过很多次的磨合(这种磨合有正确的也有错误的),我们才能知道它的价值,我们才能收获到我们需要的东西。

至于利益,”Old“是不是指公司利益,恩,确实是,很多时候我们在编码的过程中,需要赶进度,还有我们在重构中也会有一些错误出来,所以我的建议是,在开发之初,你就要在设计和重构中,不断进行磨合,不要觉得浪费时间,很多时候,好的结构能加速你的开发。

专业术语

 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

  PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

  PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Rename Method

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

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

动机:

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

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

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

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

Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Add Parameter

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

动机:

1、Add Parameter 是一个很常用的重构手法。

2、修改过的函数需要一些过去没有的信息,因此你需要给函数添加一个参数。

3、除了Add Parameter外,只要有可能,其他选择都比“Add Parameter”要好,因为有可能其他选择不会增加参数列的长度。——过长的参数列会使程序员记不住那么多参数。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Remove Parameter

状况:函数本体不再需要某个参数,那么将该参数去除。
动机:

1、参数指出函数信息,不同参数代表不同意义。函数调用这必须为每一个参数操心该传什么东西进去。——如果不去掉参数,那就为每一次调用多费一份心。

2、如果你发现有很多调用者,那么为了不让调用者操心,你可以这样做,把要移除的参数设置为某个默认值(如null),这样调用者只传那些没有默认值的参数。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Separate Query from Modifier
 
状况:如果某个函数既返回对象的状态值,又修改(副作用)对象状态(state),那么建立两个不同的函数,其中一个负责查询,另一个负责修改

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

 Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Parameterize Method
 
状况:如果若干函数做了类似的工作,但在函数本体中包含了不同的值,那么建立单一函数,以参数表达那些不同的值
动机:

1、一般是因为有少数几个值不同,所以建立了几个相似的函数。

2、分离的函数替换为一个统一的函数,通过参数来处理那些变化情况,以简化问题。

3、去除重复的代码,提高灵活性。——可以使用这个参数处理其他变化情况。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Replace Parameter with Explicit Methods
 
状况:你有一个函数,其内完全取决于参数值而采取不同的反应,那么针对该参数的每个值,建立一个独立的函数
动机:

1、如果某个参数有离散值,而函数内又以条件式检查这些参数值,并根据不同的参数值做出不同的反应,那么就应该使用本次重构。

2、可以获得好处:“编译期代码检查”,“接口更清楚”(如果用参数值决定函数行为,那么函数用户不但需要观察该函数,而且还要判断参数是否“合法化”。——而合法的参数,很少在文档中提到,必须通过上下文,才能判断)

3、不考虑“编译期检验”的好处,为了获取一个清晰的接口,我们也值得这么做。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

 
 Preserve Whole Object
 
状况:如果你从某个对象中取出若干值,将它们作为某一次函数调用中的参数,那么改使用(传递)整个对象
 动机:

1、参数列更稳固;

2、提高代码的可读性;——过长的参数列很难使用,因为调用者和被调用者都必须记住这些参数的用途。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Replace Parameter with Methods
 
状况:如果对象调用某个函数,并将所得结果做为参数,传递给另一个函数(接受参数的函数也有调用前一个函数的能力),那么让参数接受者去除该项参数,并直接调用前一个函数
 
动机:

1、如果函数通过其他途径获得参数值,那么它就不应该通过参数取得该值。

2、过长的参数列会增加程序阅读者的理解难度,因此我们应该尽可能的缩短参数列的长度。

3、方法:看看“参数接受端”是否可以通过“与调用端相同的计算”来取得参数携带值。

4、如果函数调用端通过对象内部的另一个函数来计算参数,并在计算过程中“未曾引用调用端的其他参数”,那么就可以将这个计算过程转移到被调用端内,从而去除该项参数。

 
Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Introduce Parameter Object
 
状况:某些参数总是很自然地同时出现,那么以一个对象取代这些参数
 
动机:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用


1、一组参数可能有几个函数同时使用,这些函数可能隶属于同一个class,也可能隶属于不同的classes。——这样的一组参数就是所谓的Data Clump(数据泥团)。

2、我们可以运用一个对象包装所有这些数据,再以对象取代Data Clump。——目地:哪怕只是为了把这些数据组织在一起,这样做也是值得的。

3、本项重构的价值在于“缩短了参数列的长度”。此外,新对象所定义的访问函数(accessors)还可以使代码更具一致性。——这又进一步降低了代码的理解难度和修改难度。

4、本项重构还可以带给你更多好处。——当你把这些参数组织到一起之后,往往很快可以发现“可被移植新建class“的行为。——减少重复代码。

 
Example:
 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Remove Setting Method
 
状况:你的class中的某个值域,应该在对象初创时被设置,然后就不再改变,那么去掉该值域的所有设置函数(setter)。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

动机:

1、如果你为某个值域提供了设置函数(setter),这就暗示了这个值域可以被改变。

2、如果你不希望在对象初创之后,此值域还有机会改变,那就不要为它提供设置函数。——这样你的意图会更加清晰,并且可以排除其值被修改的可能性。

Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Hide Method
 
状况:如有有一个函数,从来没有被其他class用到,那么将这个函数设置为private
 
动机:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用


1、重构往往促使你修改“函数的可见度“。——时刻检查可被隐藏的函数。

  2、经常检查有没有可能降低某个函数的可见度(使它私有化)。

——>当你在另一个class中移除对某个函数的调用时,就应该检查。

——>特别对setter函数进行上述的检查。

 
 Replace Constructor with Factory Method
 
状况:如果你希望在创建对象时不仅仅是对它做简单的构件动作,那么将__construct(构造函数)替换为factory method
动机:

在subclass过程中以factory method取代type code。——你可能常常需要type code创建相应的对象。

 Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

             PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

             PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

接着来:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 Replace Error Code with Exception
 
状况:如果某个函数返回一个特定的代码(special code),用以表示某种错误情况,那么改用异常(Exception)
 
动机:

清楚的将”普通程序“和”错误处理“分开,这使的程序更容易”理解“。

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

Example:

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

PHP 杂谈《重构-改善既有代码的设计》之五 简化函数调用

 
 conclusion
 
把我每一次的收获与大家分享,如果大家有那么一丁点的收获,也让我高兴不已。还有如在文章中有错误,望请指点一、二。
 
我不知道是不是找错地方了,有博友留言说“博客园里主要盛行C#”,看得人是不是主要以PHP程序员为主?还有很少有人给我留言,也很少有人指出我文章中的错误(难道我的文章中真的没有错误吗?),昨天”@四眼蒙面侠“给我留了言,我在与他的交谈中收获甚多,也感谢的他的批评指正,也希望能跟大家多交流。
PHP 相关文章推荐
php中截取字符串支持utf-8
Jan 18 PHP
解析crontab php自动运行的方法
Jun 24 PHP
php中in_array函数用法探究
Nov 25 PHP
Yii的CDbCriteria查询条件用法实例
Dec 04 PHP
php使用pdo连接并查询sql数据库的方法
Dec 24 PHP
php中$_POST与php://input的区别实例分析
Jan 07 PHP
php自定义函数实现汉字转换utf8编码的方法
Sep 29 PHP
thinkPHP自动验证机制详解
Dec 05 PHP
PHP levenshtein()函数用法讲解
Mar 08 PHP
Codeigniter里的无刷新上传的实现代码
Apr 14 PHP
php+lottery.js实现九宫格抽奖功能
Jul 21 PHP
在Laravel 的 Blade 模版中实现定义变量
Oct 14 PHP
PHP中数组的三种排序方法分享
May 07 #PHP
PHP面向对象三大特点学习(充分理解抽象、封装、继承、多态)
May 07 #PHP
php错误、异常处理机制(补充)
May 07 #PHP
PHP中的错误处理、异常处理机制分析
May 07 #PHP
PHP面向对象的进阶学习(抽像类、接口、final、类常量)
May 07 #PHP
PHP file_exists问题杂谈
May 07 #PHP
php提示Call-time pass-by-reference has been deprecated in的解决方法[已测]
May 06 #PHP
You might like
用PHP调用数据库的存贮过程!
2006/10/09 PHP
开启CURL扩展,让服务器支持PHP curl函数(远程采集)
2011/03/19 PHP
php 的加密函数 md5,crypt,base64_encode 等使用介绍
2012/04/09 PHP
从PHP $_SERVER相关参数判断是否支持Rewrite模块
2013/09/26 PHP
PHP实现UTF-8文件BOM自动检测与移除实例
2014/11/05 PHP
php上传文件常见问题总结
2015/02/03 PHP
详解no input file specified 三种解决方法
2019/11/29 PHP
基于PHP+Mysql简单实现了图书购物车系统的实例详解
2020/08/06 PHP
javascript编程起步(第五课)
2007/01/10 Javascript
JQuery Dialog(JS 模态窗口,可拖拽的DIV)
2010/02/07 Javascript
面向对象的Javascript之一(初识Javascript)
2012/01/20 Javascript
浏览器解析js生成的html出现样式问题的解决方法
2012/04/16 Javascript
js插件方式打开pdf文件(浏览器pdf插件分享)
2013/12/20 Javascript
使用requestAnimationFrame实现js动画性能好
2015/08/06 Javascript
AngularJS 获取ng-repeat动态生成的ng-model值实例详解
2016/11/29 Javascript
canvas实现流星雨的背景效果
2017/01/13 Javascript
详解webpack4升级指南以及从webpack3.x迁移
2018/06/12 Javascript
jQuery实现的响应鼠标移动方向插件用法示例【附源码下载】
2018/08/28 jQuery
Vue CLI3搭建的项目中路径相关问题的解决
2018/09/17 Javascript
说说如何在Vue.js中实现数字输入组件的方法
2019/01/08 Javascript
JavaScript&quot;模拟事件&quot;的注意要点详解
2019/02/13 Javascript
使用vue制作滑动标签
2019/09/21 Javascript
vue解决花括号数据绑定不成功的问题
2019/10/30 Javascript
Vue+Node实现的商城用户管理功能示例
2019/12/23 Javascript
[14:00]DOTA2国际邀请赛史上最长大战 赛后专访B神
2013/08/10 DOTA
python [:3] 实现提取数组中的数
2019/11/27 Python
Python如何使用paramiko模块连接linux
2020/03/18 Python
用OpenCV进行年龄和性别检测的实现示例
2021/01/29 Python
基于CSS3实现图片模糊过滤效果
2015/11/19 HTML / CSS
韩都衣舍天猫官方旗舰店:天猫女装销售总冠军
2017/10/10 全球购物
澳大利亚珠宝商:Shiels
2019/10/06 全球购物
简单的JAVA编程面试题
2013/03/19 面试题
职称自我鉴定
2013/10/15 职场文书
房屋买卖协议书
2014/04/10 职场文书
幼儿教师小班个人总结
2015/02/05 职场文书
小型婚礼主持词
2015/06/30 职场文书