<< Click to Display Table of Contents >> 导航:  Access专业系统培训 > Access行业开发-PERP人生管理-人脉管理 > Access标准化命名-高手必经之路

Access对象标准化命名规则与良好的注释习惯

Access高级开发必学课程

 

 

 

 

 

摘自 2005年 王宇虹 熊靖 李宏亮 《专家门诊：Access开发答疑200问》 第十六章 Access开发规范

 

摘选 2006年  王宇虹 朱亦文 陈格 朱彦志 出版的《Access数据库系统开发从基础到实践》 部分内容

 

 

 

Access高级程序员是如何炼成的

 

 一个程序员在经过一段时间的学习和训练之后，一般都可独立编写一些应用程序，而且程序也会越写越顺手，但这并不表明程序编得越多，经验就会越丰富，效率也会越高。有句古语：行百里者半九十，就是说无论做任何事，当达到一定的境界后，越往上，进展就会越来越慢，要想在原来的基础上再提高一个层次，需要付出比以前更多的努力。而且如果以前的基础打得不够扎实或是没有遵循一个严格的标准，很可能就会停滞不前，而且写得越多，心态越疲，得益越少，思维越见混乱，只能一直无休止地重复以前做过的工作，无法从代码中超脱出来以集中更多的精力来考虑客户的实际需求，为着编程而编程，实际上这些弊端都是由于没有注重编程基本功的训练导致的，我自己也是做了几年的程序员后才发现这个问题，特别是一些初学编程者，刚学会了一个编程语言，掌握了一种新的开发工具，“当手中拿着一把新锤子的时候，那看什么都是钉子”，所以动不动就想做个应用系统，把功能搞得非常复杂，代码写得老长老长，一口气可以写下几兆程序，而且让别人一时都看不懂自己的程序，就越觉得自己有实力，如果对方看得几遍，还是晕头转向，那对他来说感觉更是好极啦。其实，在现在的软件行业中，代码编写只占了整个开发周期中很少的一部分，而系统分析与功能设计以及系统运行后的维护却是占了整个软件系统中很大的比重，特别像一些非常庞大的系统，如MRP、ERP、CRM这样大型的管理软件，一般功能做到一定的程度后，都不再需要编写大量的代码，只是根据客户一些的具体需求对系统做适量的用户化修改，必要时才可能做二次开发，那在这种情况下，对程序员或实施人员来说，更多的是阅读代码，而不是编写代码，如果原来的程序员基本功扎实，按统一的标准和统一的风格编写，并且有详尽的注释及更改记录，那做二次开发的程序员将会事半功倍，甚至不必询问以前的程序员就可顺利地在已有的功能上添加新的功能和模块，因为大家遵循同一个标准，程序的风格和程序的代码就是他们的语言，这是他们沟通最好的媒介。

 最后强调一句，在基本功上花的时间永远不会嫌多的，而且每花一次，你都会有更深的认识，无论你是现在处于程序员的哪一个阶段。

 

在命名中花时间永远都不过份。

对作家而言，文章可以看出他的一生，文如其人就是此说，而对于程序员来说，码如其人，代码的风格多多少少也折射出一个程序员的性格和处事的方式，好的代码让人如饮甘醇，久久回味，差的代码让人初见无味，久而生厌。

模仿一句名言：不值得读两遍的程序，连一遍也不值得读。

在编程之前，得设想你的程序是给那些不懂程序的人看的，这样设身处地想一想，也许你就会更多地注意程序的文档和注释。事实上，程序很多时候的确是给他们看的。

 

LNC即Leszynski Naming Convention， 原来在《The Leszinski/Reddick Guidelines for Access 1.x， 2.x》这本白皮书中由Stan Leszynski 和 Greg Reddick 推荐使用的命名规则， LNC 开始于 Access 1.0这个版本， 后来随着ACCESS版本的升级，这个命名规则就被迅速传播开来， 在当今ACCESS和VB开发者和开发团体中， 它已经成为事实中的命名标准， 在国外已经广泛被使用，并被微软推荐使用， 它规范了从ACCESS数据库设计、窗体与报表的设计以及程序的编写一整套完整且易用的命名标准， 我看过国内许多VB和ACCESS源程序， 但很少人， 特别在ACCESS程序员中， 注意到命名规则并遵循某种命名约定， 这给程序交流造成了很大的困难， 同时， 由于程序员自己没有一套标准的命名规则， 在编写过程中随意命名， 随着时间的推移，  自已都难以阅读和修改以前的程序源码。

       为什么在程序编写中需要遵循一个好的命名规则呢。

首先，统一的命名标准能够让你的代码始终保持一致的风格，便于你自己看懂，也便于与别的开发人员交流和沟通，实际上，这些标准也是一种语言，这是你们沟通最好的媒介，有了它，你甚至不需更多的解释，对方就能看懂你的程序。

 

 

LNC命名规则分为两个级别，级别1是比较容易理解的，但级别2对对象进行了更严格的划分，级别1更多地适合初级程序员，而级别2则更适合于一些有经验的开发者，或在一些非常复杂或多层结构的系统开发中使用，你应该根据你自己的经验和习惯来选择更适合你的命名规则级别。请注意，不是命名规则的所有部分都分为两个级别，而只是在某些部分有所不同

 LNC命名规则是基于匈牙利命名法，为什么叫匈牙利命名法呢，主要是取自于作者的国籍，它的作者 Charles Simonyi ，也曾经使用过ACCESS的早期版本。匈牙利命名法是在他的博士论文中提到的。匈牙利命名法的一些基本原理在Visual Basic的说明手册和一些开发文档中都会被提及到，微软内部也是使用匈牙利命名法，在世界上，已经有非常多的程序员在使用这个命名法，LNC命名规则实际上是将匈牙利命名法应用到ACCESS上， 并特别针对ACCESS一些特征进行了一些完善。

 LNC命名规则提倡所有的对象的名称均由下面四个部分组成：

 一个或多个前缀、一个标记符、基本名字、限定词

[prefixes]tag[Basename][Qualifier]         注：[]里的内容表示为可选内容。

 

标记符是必须的内容，但一般情况下，你都需要一个基本名字来准确描述你的变量的实际功能，以用来区分同类型的不同意义的变量。如果你仅仅使用一个标记符来标记一个变量，那么就比较难以分辨不同的变量，但有一种情况除外，那就是你传一个对象参数给另一个函数时，可以不需要指定基本名字，例如你需要传递一个窗体对象给一个初始化窗体颜色的函数，那么这个作为参数传递的窗体对象实际上是作为一种通用的窗体对象，所以你不必为它指定一个具体的名字，而直接使用标记符即可。

 

下面举出几个简单的例子：

 

 

 

前缀和标记符总是小写的，这样当我们的眼光扫过对象名称时，目光就会停留在以大写字母开头的基本名字上面，这样提高了名称的可读性，基本名字和限定符都是以大写字母开头的。

 基本名字简洁地描述了这个对象的意义，而非描述它的类别，例如在查询qryPartNum这个名称中，PartNum就是基本名字，它是 “Part Number”的缩写，对象的标记符应该是简单且易记忆的，而前缀是放在对象名和标记符之前，用来提供更多或额外的信息，例如数字对象intPartNum前加个a, 代表这个零件号数组，即aintPartNum，更进一步，如果我们需要一个变量来指定aintPartNum这个数组的索引，那需要在这个数组的前面再加一个前缀I，那这个变量的名称应该是iaintPartNum。当然，你会发现，如果严格按照上述的规范来命名你所有的对象，需要你付出更多的努力并增加你现有的工作量，但如果一年后让你重新来修改下面这两种风格的代码，你会觉得哪种更易于修改和更易于重用呢。

第一种风格：

Z = Y(X)

第二种风格：

intPart = aintPartNum(iaintPartNum)

对象限定符是在基本名字后面再加一个符号以更具体阐明这个对象，我们还是以前面的iaintPartNum为例，如果你想为这个数组保存两个索引号，一个是第一个索引号，一个是最后一个索引号，在iaintPartNum加上限定符就变成了iaintPartNumFirst和iaintPartNumLast

 

数据库对象（表、查询、窗体、报表、宏、模块）是在ACCESS应用程序中经常被引用的对象，它们会出现在宏、VBA代码和属性中，所以如何对它们正确命名是非常重要的。

微软所带的Northwind数据库例程以及微ACCESS手册中允许对象名中存在空格，但我们不建议这种命名风格，在许多数据库引擎和编程语言中，包括ACCESS BASIC，空格是一种分隔符，它不是对象名称的一个逻辑部分，而且，在许多数据库平台中包括微软的SQL SERVER数据库和WORD文字处理程序，带有空格的名称是不能工作的。相反，使用一种大小写混合的方式来指定名称，例如：tblAccountsPayable，如果一定要使用空格，那就用下划线“_”来取代它。

 

对LNC命名规则中，所有数据容器对象都有一个标记符，在对象名称前面加上标记符对非编程人员来说可以不会增加太多可读性，但对于编程新手来说，当他们需要在报表精灵的数据源列表框或一个窗体的控件源选择一个表或查询时，添加标记符会带来很大帮助，因为ACCESS会把表和查询不加分别地放在一个长列表里。

下面是级别1的数据库容器对象的标记符：

在级别1, 数据库容器对象唯一需要的一个限定符就是 Sub, 它是放在那些子窗体或子报表的窗体名的后面. 例如窗体 frmProductSupplier 拥有一个相关的子窗体frmProductSupplierSub. 这样，一旦排序时，对象和它的子对象就会顺序排在一起。

 下面是级别2的数据库容器对象的标记符：

如果使用级别2 的命名规则，则在数据库容器里排序时，有着类似功能的对象会排在一起，当你的应用越来越大时，在你的数据库系统中可能会包含100个窗体或者更多，而其中30个窗体是用来显示消息用的，如果有一天，你需要将这个消息窗体里面的文本框的文字由黑色全部改成红色，你必须逐一打开每个窗体确定它是否消息窗体然后再修改文本框的颜色，但如果你把它们的名称设为包含同样的标记符fmsg, 那么排序时它们会排在一起，那你修改的时候就不必一个一个去筛选了，大大节约了你修改时间。

请小心仔细地选择表的名称，因为改变ACCESS对象的名称并不会自动应用到整个数据库，所以当在ACCESS对象创建时给它正确命名是非常重要的。例如，在以后的开发过程中如果需要改变表的名称，你可需要改变所有引用到到这个表名的表、查询、窗体、报表、宏和模块中引用到到这个表名，虽然，有一些辅助工具可以帮你减轻一些工作量，但最好还是在一开始就给它正确地命名。

 你可能希望引用了一个表的每个数据对象都有一个与表名一样的基本名字，而使用相应的标记符来区分它们，例如，你的表名是tblCustomer，它的主窗体名应该是frmCustomer，它的主报表名应该是rptCustomer，而引发相关这些事件的宏名应该是mfrmCustomer和mrptCustomer，我们也建议表的名称不宜用复数形式，例如使用tblCustomers，因为一个表通常都是包含多条记录的，这暗示它本身就是复数的。

 

 

数据库对象前缀

"_" 来表示那些正在开发中的对象 (举例来说,_mcrNewEmployee). 一个对象名字前面加上下划线可使它排在数据库容器的顶端，提醒你它需要注意. 当这个对象已经全部完成后 ,除去下划线，它将会正常地排序.

字段标志符

在字段上使用标志符一直是一个争议的话题,甚至在这个文章的作家之间也存在不同的见解. Greg主张字段标志符也应该统一使用与其它ACCESS数据对象及VBA中使用的一样的命名规则 ，而Stan则更喜欢使用一种与平台和数据类型无关的命名方式，即字段名称不需要加字与字段类型相关的标志符，这样有助于数据库移植和相互连通。

考虑到两者的立场，连同你自己的需求，你们可以选择在命名时是否加入下表这些标志符:

 

当你创建一个新的绑定控件时，窗体或报表会自动分配字段的名称给这个控件名称，控件与字段使用相同的名称会导致命名的混乱，特别你在VBA代码中同时引用到字段和控件，有时会导致一些错误，为避免这种情况，需要在控件名称前面加上标记符，例如一个文本框控件，它的控件来源是Customer,那么我们给它取的名称就是txtCustomer.

在级别1 中，使用者只是想区分活动控件和标签，对不太关心控件的类型，这样，控件的标记符就如下所示：

 

 

级别1描述了了控件之间一个很小的差异性的，不过，它在函数、宏或程序文档还是非常有用的，例如，通过它可以区别哪些控件是属于标签，那些是其它控件，其中前者是不可修改的，而后者则可从用户输入或代码中接受值

级别2指明了窗体或报表中控件的类型，这样VBA代码或宏更容易区分这些控件的属性和事件

 

对控件来说，唯五的前缀就是 “zs”,它只出现在级别2中，它表明这是一个系统控件，只被窗体或代码使用，而不对用户开放，例如有些控件在运行时是不可见的，但它可能用来存储一些临时值或传递参数给窗体

唯一的前缀为控制， "zs",出现在水平 2. 它指示系统- 水平被形式用或编码的控制但是不对使用者显示. 如此的控制通常不对～感到看得见的跑计时但是他们可能储存暂时的价值，否则叁数传给形式.

使用标准的描述性强的变量、常量、和函数名可大大增强代码的共享、维护、和联接的能力

每个变量都应有一个如下表所示的标记符

在我们的命名方式中，不使用$ 和 %这些数据类型前缀，因为在ACCESS和Visual basic的文档中是不推荐使用这些前缀的

象窗体和报表这样的数据库对象变量的标记符是与数据库对象的标记符是一样的，这样命名有助于编程，因为通常你分配给一个变量的名称（如tblVendor）与它所引用的对象（tblVendor）有同样的名称，这样就会在编程中提供统一的对象

使用大写名字作为常量，这是WINDOWS编程的一种习惯，

命名级别2中引入了变量和常量的范围前缀的概念，范围放在其它所有前缀的前面

 

 

为企业及个人定制各种管理系统

 

以十多年的管理和开发经验提供

 

为企业及个人提供专业培训