现在的位置: 首页 > 综合 > 正文

Learn From Real Coding (1)

2012年06月03日 ⁄ 综合 ⁄ 共 1725字 ⁄ 字号 评论关闭

注:大学毕业后,我就进入到一家软件公司从事AutoCAD应用程序开发。在随后的日子里我想通过BLOG的方式记录下我在实际工作中学习到的东西(也就是人们常说的"经验",很宝贵的哟!),然后和大家分享我的经验,也希望能和大家对相关问题进行深入的讨论。写这些的另外的一个目的记录下我成长的历程

标题:Learn From Real Coding - 1
关键词:C++中的函数重载和默认值
摘要:函数重载和默认值可以用来扩展现有的代码,而且代码的改变降到最低。

首先我需要写一个函数,用来完成在一个Drawing(AutoCAD对文档的称呼)中添加一个Circle:

Acad::ErrorStatus drawCircle(const AcGePoint3d& center,double radius);

我最初开始写这个函数的时候,考虑到这个函数可能只对当前被激活的drawing操作,所以并没有提供一个参数来
指定对那个drawing操作(AutoCAD是个多文档结构,同时可以有多个drawing被打开,但是只有一个被激活),而是
在函数的内部通过另外的函数获取当前的drawing:

Acad::ErrorStatus 
drawCircle(
const AcGePoint3d& center,double radius) ...
{
   
//get the working database

   AcDbDatabase* pWorkingDb = getWorkingDatabase();
   
//
append circle to this database
   
//...

 }

 

一开始,这个函数工作的很好,并没有出现什么问题。随着项目的进行,我需要在任何一个打开的drawing(这个drawing)可能不是当前被激活的drawing)中添加一个circle,这时候就需要添加第三个参数来指定添加到那个drawing。二话不说,我写了第二个版本的drawCircle函数的原型:

Acad::ErrorStatus 
drawCircle(const AcDbDatabase* pDB,const AcGePoint3d& center,double radius);

这里用到了C++中的函数重载特性,相似的函数可以拥有相同的函数名称,但是需要不同的参数(包括参数的类型和个数)。由于现在的代码中已经有多处已经使用到了drawCircle(),由于函数原型发生了变化,现有的代码肯定是编译不通过的。没有办法,在代码中找到所有使用了drawCircle()的地方,一一将他们替换成新的版本。在替换了几个以后,我发现大多数情况下,drawCircle()还是对当前被激活的drawing进行操作,只要少数情况下需要对其他的drawing进行操作。C++提供的的参数默认值不正是我需要的么?将当前被激活的drawing作为参数的默认值。这样我写了第三个版本的drawCircle函数的原型:

Acad::ErrorStatus 
drawCircle(const AcGePoint3d& center,double radius,
         
const AcDbDatabase* pDB = getWorkingDatabase());

对于第三个版本的drawCircle(),现有的代码不需要任何改变就可以通过编译,而且运行结果也是不变的。

通过比较第一个版本和第三个版本,第三个版本不但有第一个版本的全部功能,而且具有第一个版本所没有的通用性,第三个版本的优势是明显的。

后记
由于工作的关系,我现在开始接触一些API维护和扩展方面的内容,当我再次看到这篇文章后,我突然发现为函数增加具有默认值的参数不失为一种有效的扩展现在API的方法。在扩展现有的API的过程中,我们需要遵循的一个重要法则就是"不能(或者说尽可能小)破坏现有的代码",而为API接口增加具有默认值的参数就非常符合这个法则。

历史记录
05/05/2007    v1.1
1。添加了"后记部分"。本文讨论的内容可以作为一种有效的扩展现在API接口的方法。

08/26/2006    v1.0
原文的第一版

抱歉!评论已关闭.