改善既有代码的设计》之五 简化函数调用

思维导图

改善既有代码的设计》之五 简化函数调用



介绍

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

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

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

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

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

专业术语

 

 

 

 

 

 

改善既有代码的设计》之五 简化函数调用

 

Rename Method

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

改善既有代码的设计》之五 简化函数调用

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

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

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

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

Example:

改善既有代码的设计》之五 简化函数调用

改善既有代码的设计》之五 简化函数调用

 

改善既有代码的设计》之五 简化函数调用

改善既有代码的设计》之五 简化函数调用

Add Parameter

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

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

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:http://www.heiqu.com/6f9b0f93d147e4e410b5f12a09e299f8.html