PB命名规则及软件开发规范

1、pb 命名规则及软件开发规范软件的编写、维护和测试都是由多人协同完成的，这样在工作中就需要一些约定和规范来协调工作人员的工作。pb 虽然吸收了很多rad 工具的优点，但工具只是设施、基础，还需要优秀的方法指导。这就需要我们制定软件书写标准以规范我们的程序开发。使程序具有很好的可读性、可维护性。下面就 pbl 库划分、命名规范、注释规范、代码格式规范及界面规范进行约定。一、应用程序pbl 组成（假设应用名为app ）我们将对象进行分门别类存放，以便于查找和管理1、 share.pbl：存放应用、菜单、公用函数、公用结构。或者命名为public.pbl 。2、 app_win.pbl：存放窗口。3

2、、 app_dat.pbl：存放数据窗口对象。4、 control.pbl：存放公用的用户对象（这些对象可以直接移植到其他的项目中使用）。注：鉴于目前我们pb 开发系统状况【窗口】、【数据窗口对象】都比较多，第2 点，3 点规范不采纳，我们将对【窗口】、【数据窗口对象】都按系统大菜单的功能来命名pbl 并存放在一起。二、应用程序中对象命名规范1、 窗口命名规范窗口的名字以w_ 开头，后面加以描述其功能的英文单词。如w_label表示此窗口为标引窗口。如果a 窗口为 b 窗口（ w_label）的弹出窗口，则a 窗口应命名为w_label_pop（pop为弹出窗口功能的英文名称）。（注：不做强制

3、要求，直接w_ 模块功能名也可以）2、 数据窗口对象命名规范数据窗口对象以d_ 开头， 后面加上作为其数据源的表名。如以表 stv_class为数据源建立的数据窗口对象应命名为d_stv_class。如果对 d_stv_class进行了修改， 如更改其显示风格、增加计算字段或检索参数等，则将其命名为d_winname_label(winname为窗口名 ,label功能名 ) 。注：对【数据窗口对象】再详细说明一下，按其功能作用再分命名方式。报表：d_ 模块功能名子报表：dwc_ 模块功能名查找条件datawindow：dwf_ 模块功能名windows窗口里：dw_ 模块功能名datasto

4、re对象：ds_ 模块功能名下拉列表框datawindow：dddw_模块功能名3、 变量命名规范全局变量命名：以gt_ 开头，其中表示数据类型的第一个英文字母，后缀为变量功能名。依次类推实例变量以it_ 开头，局部变量以lt_ 开头。例如：存储xml文件 ip 地址的全局变量可定义为：string gs_xmlip。存储窗口中ddlb当前选择的索引的实例变量可定义为integer ii_index 在 dw_1:clicked!中存储 dw_1行数的变量可定义为long ll_rownum 注：对于功能意义不大，如做循环用的临时变量i， j 等可以直接定义不做额外要求。4、 函数命名规范全局

5、函数以gf_ 开头，后缀为能表示其功能的英文名称，如gf_connectdb表示连接数据库的全局函数。窗口函数以wf_ 开头，后缀为能表示其功能的英文名称，如wf_insertlb表示往 listbox中添加数据。用户对象中的函数以of_ 开头，后缀为能表示其功能的英文名称，如of_expandchild表示扩展子节点。鉴于目前我们pb 开发系统状况基本上用户对象中的函数都以ue_ 开头，所有此处我们用 ue_ 开头。5、 用户对象命名规范用户对象以uo_ 开头，后面加其功能名，如uo_treeview示此对象具有树的功能，是通用对象的命名规则。如果对uo_treeview进行特定功能的扩展，

6、则在其后加上应用的名称，如uo_treeview_app。如果窗口中的控件是继承可视化的用户对象，则在此控件的property的 tag 中应注明其父类的名字。6、 菜单命名规范菜单名称以m_ 开头，后缀为其所挂靠的窗口名称。如挂靠w_main窗口 (mdi) 的菜单名为m_main。7、 结构命名规范结构名以str_ 开头，后缀为其功能名。8、控件的命名规范窗口上控件的命名以pb 提供的缺省前缀为前缀，后缀为此控件的功能名称。三、注释1、 窗口注释在窗口的注释中说明窗口的实现的主要功能。2、 数据窗口对象注释在数据窗口对象的注释中说明其主要功能及所应用的窗口名称。3、 程序注释在程序中说明代

7、码块实现的主要功能。例如：/ 如果当前的行号无意义，则退出if row0 then return end if 注：对于不少人用 if row then return 这种简略试写法，我们不提倡。这种漏写 end if 写法，对于多个 if块 时不易阅读和调试，所以尽量避免。4、 变量注释对于全局变量和实例变量要注释说明其所要存储对象的意义。例如：string gs_xmlip / 用于存储 xml文件的 ip 地址5、 函数、事件注释在函数和事件的开始都要写上其所完成的功能，对于函数来说如果有参数的则要对参数进行说明。例如：事件注释：/= / 事件 : .() /- / 描述 : /- /

8、参数 : /- / 返回 : (none) /- / 作者 : limin 日期 : 2010 年 11 月 29 日/= 函数注释：/= / 函数 : .() /- / 描述 : /- / 参数 : /- / 返回 : (none) /- / 作者 : limin 日期 : 2010 年 11 月 29 日/= 6、 日常修改注释：/= / 修改 : /- / 作者 : limin 日期 : 2010 年 11 月 29 日/= 注：为节省代码空间，当然也不一定要求日常修改注释要多行，也可以只写一行注释语句。但是要求必须包括三部门：【修改人】、 【修改日期】 、 【修改内容】 。修改其他同事

9、的代码时，原代码内容尽量保留并注释掉。对于大块功能代码可以用 / begin 功能名 和 /end 功能名 例如：/ begin 功能名 . . /end 功能名四、代码格式规范代码格式规范包括代码对齐，代码布局。1、 根据功能或功能完成步骤将脚本用空行分隔成段。例如：dw_1.settransobject( sqlca) dw_1.retrieve( ) insert_ddlb() insert_lb() 2、 条件或循环语句中的代码要缩进。例如：if li_label=3 then gb_2.text=未审校 end if 3、 代码缩进一律使用tab 键。默认tab 值为 3 个空格4、

10、 变量全部用小写。五、界面规范1、窗口、菜单、控件的布局和风格要统一，控件布局要准确窗口中的控件文字包括字体、颜色、大小、字体大小、字体粗细、背景颜色要一致，同一应用中的窗口和控件采用一种风格，而且在不同窗口中，功能相近的按钮最好设置在同样的位置。按钮控件需要进行细致布局，作到大小相等、行列对齐。推荐用 9 号宋体最为屏幕显示字体，这是中文windows中提供一种的适合屏幕显示的最小字体，这种字体没有毛刺，很自然。注：我们不一定要求是9 号字，但是要和整套系统字体格式统一，一些标题等客户要求字体除外。2、窗口标题文字描述统一规范统一使用窗口功能名加上当前登录人。例如：目前焦点窗口为标引管理，登录人为超级用户，则窗口标题应为：标引管理超级用户。（注：该处不做要求，因为我们系统一般主界面的任务栏有显示登录用户）3、窗口中隐藏控件不要太多窗口中隐藏控件太多的话，会导致窗口内布局比较混乱，并且会给合作人造成理解上的困难。4、图片文件的管理图片文件要存放在一个统一的文件夹内，并将其命名为images。程序中图片的路径都取相对路径。 针对目前我们pb 开发系统有images，pic ，sign 三种文件夹命名，故以后都必须集中在 pic 文件夹下，以前的都不在处理。六、数据库操作在程序中利用sql 语句或数据窗口对数据库进行插入、删除、 修改更新时， 都要判断操作结果