《计算机编码程序的设计说明书》由会员分享,可在线阅读,更多相关《计算机编码程序的设计说明书(18页珍藏版)》请在金锄头文库上搜索。
1、计算机编码程序设计说明书第 1 章 序言所谓编码就是基于在程序设计时作成的程序设计书和流程图等逻辑设计、用编程语言、对为在计算机上实现某些功能的逻辑进行描述的工作。在编码过程中、为了消除因程序员水平不同而造成的差异、为了顺利的进入单体测试阶段、同时也为了维护方便、以下整理了编码的准备和代码书写的标准。而且、关于书写标准、除非客户有指定的要求、或者使用了(半)自动生成代码的工具话、则应尽量遵从这个标准。本规范是以使用Microsoft 的 Visual Basic 来开发PC的应用程序为前提的。第 2 章 编码的准备(1) 以系统设计书、程序设计书(根据情况也包含流程图等的逻辑设计书)为基础。(
2、2) 在完全理解了以上文档内容的基础上开始编码工作(特别是程序设计书的作者和编码的担当者不同时)。对于不明白的地方不要随意判断、要进行确认。(3) 始终注意要把程序的易理解性(易读性)放在第一位。为此、在编程时要时刻想着程序的读者、本着以向读者说明的态度来编写程序是写好程序的关键。读起来容易理解的程序一般来说总是质量优良、而且容易改造的。(4) 象数据库的记录的规范等include文件、模块头、宏定义等系统应该统一的东西、要采用系统规定的东西、不要根据个人的意愿随意的作成、否则、这将成为在进行变更和改造时发生问题的原因。(5) 编码结束后、要对代码进行检查。不检查代码则不能轻易的进入下一步的测
3、试阶段的工作。检查代码不仅是最容易发现错误的方法、而且有时还能检出在测试时不易发现的复杂错误。第 3章 命名规约3 1 . 使用的目的命名规约以以下4点为目的的而使用。(1) Object名容易明白会使应用程序的结构代码等容易理解。(2) 确立开发小组“通用语言”、使全体成员用同样的“语言”来开发应用程序。(3) 使VB Jet的Object 容易被使用。(4) 用较少的劳力作成VB开发用的工具、在各式各样的VBA 平台里通用的源码库。本规约是用遵从被VisualBasic作为标准的 Lezynski命名规则(Lezynski Naming Convention、 以下称LNC)的方法来规定命
4、名法的。3 2 . Object的结构化LNC按以下格式对Object进行命名。 Prefix tag BaseName Quantifier Suffix Prefix前缀Tag标签BaseName基本名Quantifier量词Suffix后缀对各个部分按顺序进行说明。. 前缀(prefix)前缀是在标签前面的识别符、是对标签进行进一步详细说明的。前缀用1到2个小写字母组成。对1个Object复数个前缀可以组合使用。前缀有表示有效范围的和表示变量特性的。另外、2个前缀能够重叠使用。(1) 表示有效范围的前缀表1 . 表示有效范围的前缀无Procedure内的局部变量s用Static声明的Pr
5、ocedure的局部变量m在模块Declarations Section 的用Dim 或Private声明的模块水平的变量p在模块的Declarations Section用Public声明的变量g在模块的Declarations Section作为Public或Global声明的变量(2) 表示变量特性的前缀表2. 表示变量特性的前缀a作为数组声明的变量c用Const声明的变量e作为的Collection1个要素的变量i作为数组的Index或循环的计数器使用的变量r传递给Procedure参数的作为参照传递( ByRef )声明的变量t作为用户定义型定义的变量v传递给Procedure参数的
6、作为值传递( ByVal )声明的变量(3) 例值传递的参数:vintCount参照传递的参数: rstrFileName在Declarations用public声明的数组的Index变量:apintMember用Const声明的变量:cintFNAMEMAX3 4 . 标签(tag)标签是表示基本名的特征的复数个的字母、放在基本名的前面。标签基本上相当于面向Object编程的类识别符。标签用3到4个小写字母组成。标签是表示基本名的特征的复数个的字母、表示变量的型啦的种类。从标签表示的意思上可以对数据型、模块、Form、控件的标签进行分类。(1) 数据型表3. 数据型标签布尔值bln长整数ln
7、gBytebytObjectobj双精度浮点数dbl字符串str错误err用户定义typ整数intVariantvar(2) 模块、Form、控件表4 模块标签 表5. 标签类模块cls对话框fdlg标准模块bas菜单fmnuFormfrm表6. 控件标签Command ButtoncmdOption Buttonopt控件ctlPocturepic,picsCombo BoxcboPrinterprn,prns菜单mnu属性prp,prps菜单项mni,mnisTabtab,tabsNodenod,modsText BoxtxtList BoxlstCommon Dialogcdlg(3)
8、例l 判定成功用的变量:blnSuccessl 文件名:strFileNamel 检索处理用的标准模块:basSearchDatal 主Form:frmMainl Start Button:cmdStartl Font Dialog:cdlgFont3 5 . 基本名(BaseName)基本名是设Object名是最先遇到的部分、是不管采用不采用命名规则都必须使用的名字。基本名要用有意义的单词(原则上用英文单词)来组合、各个单词的第一个字母大写其余用小写。这时、再加上专用名词的情况下、要用日语的罗马字。但是、用Const声明的变量的基本名全部用大写。另外、虽然没有限制、基本名还是要选择不太长的名
9、字。作为基本名的样本用在VB编码里的标准的作业变量表示如下。表7 . 标准LNC作业变量blnRET接受函数调用的返回值( True/False )intErr保持Err的值intLoop循环计数器intMsg接受MsgBox函数的返回值intResult保持算术演算的接果(dblresult 、lngResult 也同样)intRet接受函数调用的返回值(dblRet、lngRet也同样)intWord用在所有暂时的作业(dblWord 、 lngWork也同样)strMsg作成Message Box字符串3 6 . 量词( Qualifier)量词表示Object在关联上是怎样被利用的。(
10、最大、最小等)量词要尽量短、用大写.小写字母的组合来表示。表8 . 量词Curr存贮1Set内的现在的要素First存贮1Set内的最初的要素Hold存贮以后要使用的要素Last存贮1Set内的最后的要素Max存贮1Set内的最大要素Min存贮1Set内的最小要素Next存贮1Set内的下一个的要素New存贮的新的instance或值Oid存贮的以前的instance或值Prev存贮1Set内的前面的要素Src存贮SourceTemp存贮暂时的值3 7 . 后缀(Suffix)后缀是以在按照命名规则时变成的名字的Object名上识别符为目的而添加的。所以不是非要不可、根据Project决定是否
11、采用。假设DB关联的标准模块有SortData、DeleteData、InsertData、UpdateData4个。这时、如果存贮错误码的变量设为、在各个模块里确保变量的话、就会区别不开。如果在取各个模块的大写的2个字母作后缀、各个变量就能区别开。SortData( SD )-gintErr_SDDeleteData( DD )-gintErr_DDDeleteData( ID )-gintErr_IDDeleteData( UD )-gintErr_UD虽然后缀的决定方法没有特别的基准、还是要选择容易明白区别基准的2到3个字母的字符串。另外、大写字母、小写字母可以任意使用。第章模块头 模块
12、头对了解模块的概要是很有效的、另外还有助于维护。所以、对此必须记述。4 1 . 外部模块头外部模块头要记述以下项目。(有关程序全体的信息在Include文件(文件名=程序名.h)记述。)( a )模块识别信息 系统名 客户名 程序名或模块名 担当部科名 著作权表示( b ) 模块说明 功能 参数说明 动作环境/作成环境 作成担当着名( c ) 履历 作成日时(单体试验完成日) 变更日时 变更内容 版本信息( d )补充说明 外部模块头*Copyright Shenyang NETS System Integration Co. Ltd.1998.All Rights Reserved.系统名 :系统名客户 :客户 程序 :程序名称担当部长 :沈阳东东系统集成有限公司 开发一部*功能 :功能概要参数 :对有关重要参数进行说明作成环境 :工具、编译环境、OS动作环境 :OS、制约条件担当 :担当者名作成日 :1999年5月28日 (Ver.0)*变更履历 Ver.0.1 1999年5月28日 所属 担当者名 变更理由 变更内容Ver.1.0 1999年6月15日 所属 担当者名 变更理由 变更内容*/4 2 . 内部模块头在内部模块头写下以下项目。