PowerBuilder环境开发规范.docVIP

PowerBuilder 环境开发规范 目　　　　录 1. 对象和控制命名规范 对象和控制命名规范 对象和控制的名字都由前缀加名字构成。不同对象和控制的前缀名称使用PowerBuilder的默认值，如下表所示： 对象或控制 前缀 Window w_ Menu m_ UserObject uo_ DataWindow d_ DataWindow Control dw_ SingleLineEdit sle_ MultiLineEdit mle_ CommandButton cb_ EditMask em_ CheckBox cbx_ ListBox lb_ RadioButton rb_ DropDownListBox ddlb_ Picture p_ Graph gr_ OLE ole_ Global Function gf_ Window Function wf_ User Object Function uf_ 用户事件的命名前缀使用ue_。 名字的其他部分必须使用能反映对象功能的单词，以有利于程序的阅读。如：一个功能为“关闭”的按钮，其名字为cb_close。不能使用序号来标识Window中同类控制。如cb_1,cb_2等。 变量名不要使用拼音缩写，其名字从英文字面上应尽可能反映其用途。 DataWindow的定义中，计算字段必须显式命名，不能使用诸如“compute_001”之类含糊不清的缺省命名。 编程风格 程序中必须进行注解。注释使用中文。 一行只定义一个变量，每个变量后面必须注释其用途。 每个较为独立的程序段落用空行分隔，段落前用注解说明该段程序的功能。关键语句要注解。 程序中的保留字用大写，对象名称用小写。Script程序中的SQL语句保留字用大写。 Script语句在不同的层次上采用缩进格式，每层缩进一个TAB位置。 数据校验 应用系统必须对用户录入的数据进行校验以确保数据的质量。在PowerBuilder应用程序中，有三处进行数据校验的时机或三个校验层次：字段编辑时、整个记录录入时、写入数据库时。前两种校验由应用程序实现，写入数据库时的校验完全取决于数据库中定义的校验规则，由数据库管理系统本身实现。 为了对用户友好、减轻对数据库定义的依赖，应用程序必须依靠自身实现数据的校验，而不得将未校验的数据直接提交数据库系统。 字段编辑一般完成相对简单的取值范围校验，并且一般不与其他字段进行相关校验。字段校验的功能应避免出现由于其他字段的错误，导致不能正常离开当前字段的情况。进行字段校验的方法有：使用特定的控制保证用户只输入合法值，如复选框、下拉列表等；使用编辑屏蔽（MASK）；使用校验规则；使用自编的校验函数（对于相对复杂的情形）。 在整个记录的字段录入完毕，用户发出写入数据库的指令时，可以通过Script程序进行相对复杂的校验，如字段之间的相关性检查、非空检查、与其他数据的相关性检查等。 在字段编辑状态下，一般不要使用非空限制，以避免用户不能将光标随意地在字段间移动。将这一限制留待记录录入时检查。 环境配置与应用的可移植性 为了对不同安装运行环境的适应以及各项功能的剪裁，应用程序应使用配置文件记录各种参数及选项。 配置文件的格式遵守Windows应用的标准配置文件格式，即INI文件。文件包含多个节（Section），每节由一组相关的配置参数组成，每节有一个包含在方括号中的节名；每个配置参数由一个关键词（Key）后跟一个等号及参数值组成。 配置文件名一般应与应用程序的名字相同。 凡是需要连接数据库的应用，在INI文件中必须有一个database节，以描述数据库的连接参数。该节包含的参数与Powerbuilder中规定的向数据库连接的参数相同，但在dbparm参数中的connectstring中不能包含pwd选项。 应用程序应可以安装到任意用户指定的路径下，程序操作中不得使用具体的绝对路径。配置文件与执行程序本身放入同一路径下，可以将所安装的路径记载到配置文件中。程序中可以约定在安装路径下建立自己的相对目录。 应用程序必须能方便地移植到不同的单位运行。在程序中引用的项目代码或名称，可以分为本系统定义和由用户定义两种情况。由本系统定义的项目，可以在程序代码中固定引用，如写入列表框中；由用户定义的项目则不能直接出现在程序中。 事件驱动 在Windows事件驱动的运行模式下，靠事件激活和调度不同的程序片段运行。在PB编程中应充分利用事件将程序划分作不同的功能片段，以利于代码的共享。 在编程中应以一个功能保持一个入口和一个出口的原则来划分程序、选择触发该功能的事件。如：关闭一个窗口可能有多个途径，有关关闭窗口时的操作应在窗口的close事件中完成，这样既防止入口遗漏，又提高了代