`
sundful
  • 浏览: 1250070 次
  • 性别: Icon_minigender_1
  • 来自: 北京
社区版块
存档分类
最新评论

高质量代码的三要素(二)

    博客分类:
  • Java
阅读更多

3.可变更性

前面我提到了,软件的变更性是所有软件理论的核心,那么什么是软件的可变更性呢?按照现在的软件理论,客户对软件的需求时时刻刻在发生着变化。当软件设计好以后,为应对客户需求的变更而进行的代码修改,其所需要付出的代价,就是软件设计的可变更性。由于软件合理地设计,修改所付出的代价越小,则软件的可变更性越好,即代码设计的质量越高。一种非常理想的状态是,无论客户需求怎样变化,软件只需进行适当地修改就能够适应。但这之所以称之为理想状态,因为客户需求变化是有大有小的。如果客户需求变化非常大,即使再好的设计也无法应付,甚至重新开发。然而,客户需求的适当变化,一个合理地设计可以使得变更代价最小化,延续我们设计的软件的生命力。

1)通过提高代码复用提高可维护性

我曾经遇到过这样一件事,我要维护的一个系统因为应用范围的扩大,它对机关级次的计算方式需要改变一种策略。如果这个项目统一采用一段公用方法来计算机关级次,这样一个修改实在太简单了,就是修改这个公用方法即可。但是,事实却不一样,对机关级次计算的代码遍布整个项目,甚至有些还写入到了那些复杂的SQL语句中。在这样一种情况下,这样一个需求的修改无异于需要遍历这个项目代码。这样一个实例显示了一个项目代码复用的重要,然而不幸的是,代码无法很好复用的情况遍布我们所有的项目。代码复用的道理十分简单,但要具体运作起来非常复杂,它除了需要很好的代码规划,还需要持续地代码重构。

对整个系统的整体分析与合理规划可以根本地保证代码复用。系统分析师通过用例模型、领域模型、分析模型的一步一步分析,最后通过正向工程,生成系统需要设计的各种类及其各自的属性和方法。采用这种方法,功能被合理地划分到这个类中,可以很好地保证代码复用。

采用以上方法虽然好,但技术难度较高,需要有高深的系统分析师,并不是所有项目都能普遍采用的,特别是时间比较紧张的项目。通过开发人员在设计过程中的重构,也许更加实用。当某个开发人员在开发一段代码时,发现该功能与前面已经开发功能相同,或者部分相同。这时,这个开发人员可以对前面已经开发的功能进行重构,将可以通用的代码提取出来,进行相应地改造,使其具有一定的通用性,便于各个地方可以使用。

一些比较成功的项目组会指定一个专门管理通用代码的人,负责收集和整理项目组中各个成员编写的,可以通用的代码。这个负责人同时也应当具有一定的代码编写功力,因为将专用代码提升为通用代码,或者以前使用该通用代码的某个功能,由于业务变更,而对这个通用代码的变更要求,都对这个负责人提出了很高的能力要求。

虽然后一种方式非常实用,但是它有些亡羊补牢的味道,不能从整体上对项目代码进行有效规划。正因为两种方法各有利弊,因此在项目中应当配合使用。

2)利用设计模式提高可变更性

对于初学者,软件设计理论常常感觉晦涩难懂。一个快速提高软件质量的捷径就是利用设计模式。这里说的设计模式,不仅仅指经典的32个模式,是一切前人总结的,我们可以利用的、更加广泛的设计模式。

 

a. if...else...

这个我也不知道叫什么名字,最早是哪位大师总结的,它出现在Larman的《UML与模式应用》,也出现在出现在Mardin的《敏捷软件开发》。它是这样描述的:当你发现你必须要设计这样的代码:“if...elseif...elseif...else...”时,你应当想到你的代码应当重构一下了。我们先看看这样的代码有怎样的特点。

 

 

Java代码 复制代码
  1.            if(var.equals("A")){   
  2.     doA();   
  3. }else if(var.equals("B")){   
  4.     doB();   
  5. }else if(var.equals("C")){   
  6.     doC();   
  7. }else{   
  8.     doD();   
  9. }  
                if(var.equals("A")){
    		doA();
    	}else if(var.equals("B")){
    		doB();
    	}else if(var.equals("C")){
    		doC();
    	}else{
    		doD();
    	}

  

 

 

 

这样的代码很常见,也非常平常,我们大家都写过。但正是这样平常才隐藏着我们永远没有注意的问题。问题就在于,如果某一天这个选项不再仅仅是ABC,而是增加了新的选项,会怎样呢?你也许会说,那没有关系,我把代码改改就行。然而事实上并非如此,在大型软件研发与维护中有一个原则,每次的变更尽量不要去修改原有的代码。如果我们重构一下,能保证不修改原有代码,仅仅增加新的代码就能应付选项的增加,这就增加了这段代码的可维护性和可变更性,提高了代码质量。那么,我们应当如何去做呢?

 

经过深入分析你会发现,这里存在一个对应关系,即A对应doA()B对应doB()...如果将doA()doB()doC()...与原有代码解耦,问题就解决了。如何解耦呢?设计一个接口X以及它的实现ABC...每个类都包含一个方法doX(),并且将doA()的代码放到A.doX()中,将doB()的代码放到B.doX()中...经过以上的重构,代码还是这些代码,效果却完全不一样了。我们只需要这样写:

 

 

 

 

 

这样就可以实现以上的功能了。我们看到这里有一个工厂,放着所有的ABC...并且与它们的key对应起来,并且写在配置文件中。如果出现新的选项时,通过修改配置文件就可以无限制的增加下去。

这个模式虽然有效提高了代码质量,但是不能滥用,并非只要出现if...else...就需要使用。由于它使用了工厂,一定程度上增加了代码复杂度,因此仅仅在选项较多,并且增加选项的可能性很大的情况下才可以使用。另外,要使用这个模式,继承我在附件中提供的抽象类XmlBuildFactoryFacade就可以快速建立一个工厂。如果你的项目放在spring或其它可配置框架中,也可以快速建立工厂。设计一个Map静态属性并使其V为这些ABC...这个工厂就建立起来了。

 

b.策略模式

也许你看过策略模式(strategy model)的相关资料但没有留下太多的印象。一个简单的例子可以让你快速理解它。如果一个员工系统中,员工被分为临时工和正式工并且在不同的地方相应的行为不一样。在设计它们的时候,你肯定设计一个抽象的员工类,并且设计两个继承类:临时工和正式工。这样,通过下塑类型,可以在不同的地方表现出临时工和正式工的各自行为。在另一个系统中,员工被分为了销售人员、技术人员、管理人员并且也在不同的地方相应的行为不一样。同样,我们在设计时也是设计一个抽象的员工类,并且设计数个继承类:销售人员、技术人员、管理人员。现在,我们要把这两个系统合并起来,也就是说,在新的系统中,员工既被分为临时工和正式工,又被分为了销售人员、技术人员、管理人员,这时候如何设计。如果我们还是使用以往的设计,我们将不得不设计很多继承类:销售临时工、销售正式工、技术临时工、技术正式工...如此的设计,在随着划分的类型,以及每种类型的选项的增多,呈笛卡尔增长。通过以上一个系统的设计,我们不得不发现,我们以往学习的关于继承的设计遇到了挑战。

解决继承出现的问题,有一个最好的办法,就是采用策略模式。在这个应用中,员工之所以要分为临时工和正式工,无非是因为它们的一些行为不一样,比如,发工资时的计算方式不同。如果我们在设计时不将员工类分为临时工类和正式工类,而仅仅只有员工类,只是在类中增加“工资发放策略”。当我们创建员工对象时,根据员工的类型,将“工资发放策略”设定为“临时工策略”或“正式工策略”,在计算工资时,只需要调用策略类中的“计算工资”方法,其行为的表现,也设计临时工类和正式工类是一样的。同样的设计可以放到销售人员策略、技术人员策略、管理人员策略中。一个通常的设计是,我们将某一个影响更大的、或者选项更少的属性设计成继承类,而将其它属性设计成策略类,就可以很好的解决以上问题。

 



 

 

 

使用策略模式,你同样把代码写活了,因为你可以无限制地增加策略。但是,使用策略模式你同样需要设计一个工厂——策略工厂。以上实例中,你需要设计一个发放工资策略工厂,并且在工厂中将“临时工”与“临时工策略”对应起来,将“正式工”与“正式工策略”对应起来。

 

c.适配器模式

我的笔记本是港货,它的插头与我们常用的插座不一样,所有我出差的时候我必须带一个适配器,才能使用不同地方的插座。这是一个对适配器模式最经典的描述。当我们设计的系统要与其它系统交互,或者我们设计的模块要与其它模块交互时,这种交互可能是调用一个接口,或者交换一段数据,接受方常常因发送方对协议的变更而频繁变更。这种变更,可能是接受方来源的变更,比如原来是A系统,现在变成B系统了;也可能是接受方自身的代码变更,如原来的接口现在增加了一个参数。由于发送方的变更常常导致接受方代码的不稳定,即频繁跟着修改,为接受方的维护带来困难。

遇到这样的问题,一个有经验的程序员马上想到的就是采用适配器模式。在设计时,我方的接口按照某个协议编写,并且保持固定不变。然后,在与真正对方接口时,在前段设计一个适配器类,一旦对方协议发生变更,我可以换个适配器,将新协议转换成原协议,问题就解决了。适配器模式应当包含一个接口和它的实现类。接口应当包含一个本系统要调用的方法,而它的实现类分别是与A系统接口的适配器、与B系统接口的适配器...

 



 

 

我曾经在一个项目中需要与另一个系统接口,起初那个系统通过一个数据集的方式为我提供数据,我写了一个接收数据集的适配器;后来改为用一个XML数据流的形式,我又写了一个接收XML的适配器。虽然为我提供数据的方式不同,但是经过适配器转换后,输出的数据是一样的。通过在spring中的配置,我可以灵活地切换到底是使用哪个适配器。

 

d.外观模式

32个经典模式中的外观模式,对开发者的代码规划能力提出了更高的要求,它要求开发者对自己开发的所有代码有一个相互联系和从中抽象的能力,从各个不同的模块和各个不同的功能中,抽象出其过程比较一致的通用流程,最终形成外观。譬如说,读取XML并形成工厂,是许多模块常常要使用的功能。它们虽然有各自的不同,但是总体流程都是一样的:读取XML文件、解析XML数据流、形成工厂。正因为有这样的特征,它们可以使用共同的外观,那么,什么是外观模式呢?

外观模式(Façade Model)通常有一个抽象类。在这个抽象类中,通常有一个主函数,按照一定地顺序去调用其它函数。而其它函数往往是某这个连续过程中的各个步骤,如以上实例中的读取XML文件、解析XML数据流、形成工厂等步骤。由于这是一个抽象类,这些步骤函数可以是抽象函数。抽象类仅仅定义了整个过程的执行顺序,以及一些可以通用的步骤(如读取XML文件和解析XML数据流),而另一些比较个性的步骤,则由它的继承类自己去完成(如上例中的“形成工厂”,由于各个工厂各不一样,因此由各自的继承类自己去决定它的工厂是怎样形成的)。

 



 

 

各个继承类可以根据自己的需要,通过重载重新定义各个步骤函数。但是,外观模式要求不能重载主函数,因此正规的外观模式其主函数应当是final(虽然我们常常不这么写)。另外,外观模式还允许你定义的这个步骤中,有些步骤是可选步骤。对与可选步骤,我们通常称为“钩子(hood)”。它在编写时,在抽象类中并不是一个抽象函数,但却是一个什么都不写的空函数。继承类在编写时,如果需要这个步骤则重载这个函数,否则就什么也不写,进而在执行的时候也如同什么都没有执行。

通过以上对外观模式的描述可以发现,外观模式可以大大地提高我们的代码复用程度。

以上一些常用设计模式,都能使我们快速提高代码质量。还是那句话,设计模式不是什么高深的东西,恰恰相反,它是初学者快速提高的捷径。然而,如果说提高代码复用是提高代码质量的初阶,使用设计模式也只能是提高代码质量的中阶。那么,什么是高阶呢?我认为是那些分析设计理论,更具体地说,就是职责驱动设计和领域驱动设计。

Java代码 复制代码
  1. X x = factory.getBean(var);   
  2. x.doX();  
X x = factory.getBean(var);
x.doX();

 

1
0
分享到:
评论

相关推荐

    高质量代码有三要素:可读性、可维护性、可变更性

    我们评价高质量代码有三要素:可读性、可维护性、可变更性。我们的代码要一个都不能少地达到了这三要素的要求才能算高质量的代码。一提到可读性似乎有一些老生常谈的味道,但令人沮丧的是,虽然大家一而再,再而三地...

    如何编写出高质量代码的核心要素

    如何编写出高质量代码的核心要素

    编写高质量代码之C#、C++_nodrm.azw3

    《编写高质量代码:改善c#程序的157个建议》一共三个部分,第一部分专注于c#语言本身,一共89条建议,涵盖了c#语言基本要素、集合、linq、泛型、委托、事件、资源管理、序列化、异常处理、异步、多线程、任务和并行...

    如何提高代码质量

    【提高代码质量】是软件开发中的核心议题,无论是个人还是团队,都需要关注代码的质量,因为高质量的代码直接影响到项目的可持续发展、维护...只有这样,才能编写出既能满足当前需求,又能适应未来变化的高质量代码。

    html+js+css, 编写高质量代码-web前端开发修炼之道-源代码

    html+js+css, 编写高质量代码-web前端开发修炼之道-源代码 本书的核心内容是围绕Web 前端开发的三大技术要素——HTML、CSS 和JavaScript 来深入地 探讨编写高质量的HTML 代码、CSS 代码和JavaScript 代码的方法、...

    地形要素分类代码与图式符号

    地形要素分类代码与图式符号是地理信息系统(GIS)和地图制图领域中的核心概念,它们对于准确地表达和理解地球...理解和掌握这些知识,能够帮助制图者高效、准确地制作出高质量的地形图,服务于多个领域的决策和研究。

    名企前端面试真题质量的代码,讨论影响代码质量的3个要素(规范性、完整性和鲁棒性),强调高质量代码除完成基本功能外,还能考虑特殊情

    这里我们将深入探讨影响代码质量的三个要素:规范性、完整性和鲁棒性。 1. 规范性:遵循一定的编码规范可以提高代码的可读性和可维护性。例如,在HTML中,正确地闭合标签,使用语义化的标签,如`<header>`、`<nav>`...

    如何构建高质量前端代码.pdf

    **设计原则**是指导我们编写高质量代码的准则。其中,**开闭原则**要求软件实体对扩展开放,对修改关闭,这意味着我们可以添加新功能而不破坏现有代码。**单一职责原则**确保每个类或模块只有一个明确的责任。**依赖...

    【转】如何编写高质量的代码

    在编程领域,编写高质量的代码是每个开发者的追求。高质量的代码不仅运行效率高,可维护性...以上这些知识点都是编写高质量代码的关键要素,通过不断学习和实践,开发者可以逐步提升自己的编程技能,写出更优秀的代码。

    高质量C++编程指南pdf

    综上所述,这份“高质量C++编程指南”将涵盖C++语言的关键要素,包括但不限于基本语法、面向对象编程、异常处理、内存管理、模板、STL库的使用,以及如何编写可维护的代码。同时,由于C++与C的兼容性,书中可能也会...

    《编写高质量代码:改善c#程序的157个建议》第1章和第6章

    本书是一本关于如何编写高质量C#代码的工具书,列举的问题非常典型,给出的建议也非常实用,其中的每一条建议都有可能在我们编写下一行代码的时候用到。你可以将此书搁置在案头,以便有需要的时候随时查阅。

    高质量程序设计指南

    《高质量程序设计指南》是一本深入探讨C++和C语言编程实践的专业书籍,旨在帮助开发者提升代码质量和效率。书中的内容涵盖了从基本概念到高级特性的全面指导,旨在培养程序员编写出更健壮、可维护性更强的软件。 在...

    A股上市公司全要素生产率TFP数据(5种测算方法),包含原始数据及测算代码,2000-2022

    济已由高速增长阶段转向高质量发展阶段,提高全要素生产率成为经济高质量发展的动力源 泉。 因此,以全要素生产率的提升提动经济高质量、可持续发展成为重要方向。 企业作 为微观主体之一,提高全要素生产率水平,...

    高质量C++/C编程指南

    #### 三、高质量编程的基本原则 1. **编程风格**: - 一致性和简洁性是高质量编程的基石。良好的编程风格有助于提高代码的可读性和可维护性。 - 使用有意义的变量名、避免冗余代码、合理组织模块结构等都是提高...

Global site tag (gtag.js) - Google Analytics