PBPB编码规范doc文档格式.docx

1、如果软件功能发生重大变化时，主版本号变化。*对象命名规范*命名约定a.部件名称可以达到40个字符，组成方式为A_B。b.A部分表示前缀，表示部件的类型。c.紧跟着一条下划线_d.B部分描述此部件的名称。可以根据情况具体决定B的构成。推荐将B部分分解成两部分：功能代码_功能描述。e.在重要变量后面写注解表示此变量的用途。比如，常用的几种对象命名是窗口的命名：w_功能代码_功能描述。数据窗口控件的命名：dw_功能代码_功能描述。数据窗口对象的命名：d_功能代码_功能描述。菜单命名：m_功能代码_功能描述。用户对象：uo_功能代码_功能描述。*具体命名规则1.函数的命名规则函数名=函数适用范围代码+

2、f_函数功能描述，其中函数的适用范围代码和意义如下：g全局函数；w窗口函数；m菜单函数；u用户对象函数。例：检查SQL语句执行结果的全局用户函数命名如下：gf_checksql（）。2.应用应用的命名应使用与该应用的意义相关联的英文字母，例如，app_si表示社会保险应用系统。3.PBL库PBL库组织的好坏很重要，它会影响应用开发和维护的容易程度以及应用的性能。Library的组织应遵循以下原则：a.Library的大小。PowerBuilder对Library的大小没有限制，但最好使之小于1MB，Library太大，PowerBuilder要花更多的时间去打开和存储对象，这会影响开发的效率。

3、b.Library的数量。尽量用最少的Library数量。应在Library的数量和每个Library中对象数量之间找到平衡点，如果Library数量太多而每个Library中对象数量太少，搜索路径会太长，影响运行效率。c.Library的优化。要在Library画笔中经常对Library进行优化。随着时间的推移，Library会被分段，会使Library的存储变得不连续，影响运行效率。d.Library的分类组织。PBL库可按子系统或功能组织，一般应用都包含公共PBL库。每个PBL库文件命名应该与该文件作用相关联，例如报表PBL库文件命名为report.pbl。每个PBL库文件应该包含详细注

4、释，列出该PBL文件包含哪些对象，对应哪个子系统，与其他PBL（调用）关系等信息。为了有效地进行团队开发，实现对PB源码的管理，要求基于对各方因素（如应用代码的执行效率和所占存储空间）和维护上的全面考虑，对PB源码实行分类的原则。PowerBuilder的Library的分类原则有两种方式：（1）制定对象分类法根据所制定的不同类的对象进行分类。将所有的窗口放在一个Library中。（2）功能模块分类法根据系统的功能模块的不同，将属于不同类的制定对象放在一个Library中。这是一种更为有效的方式。4.初始化配置文件初始化配置文件的命名必须与应用的名称一致，扩展名为.ini，例如：si.ini。

5、用户的可变环境信息都应该保存在该文件中，关键信息加密保存，并且提供管理工具，而不是手工修改该文件。5.资源文件资源文件的命名必须与应用的名称一致，扩展名为.pbr，例如：si.pbr。6.窗口窗口的命名必须以w（Window的首字符）开头，加下划线（_），其后紧接与窗口意义相关联的英文字母（总长不得超过PowerBuilder的40个字符限制），并且在注释（Comments）框内写出该窗口的作用（中文或英文），如下所示。序号窗口名称Comments 1w_about关于本系统的版权信息2 w_system_error系统出错提示3 w_main系统主界面4 w_report_sheet报表输出

6、7.数据窗口普通数据窗口的命名必须以dW（DataWindow缩写）开头，代码表下拉式子数据窗口必须以dddw（DropDownDataWindow缩写）开头，加下划线（_），其后紧接与数据窗口意义相关联的英文字母（总长不得超过PowerBuilder的40个字符限制），并且在Comments框内写出该数据窗口的作用（中文或英文），如下所示。序号数据窗口名称Comments 1d_system_error显示系统错误，被w_System_Error窗口调用2 d_categories对产品分类，被w_Report_Sheet窗口调用3 d_detail_parts Parts of Produ

7、cts Described in Detail 4d_detail_function Products Function Described in Detail 5dddw_sex性别代码表8.菜单菜单的命名必须以m（Menu缩写）开头，加下划线（_），其后紧接与菜单意义相关联的英文字母（总长不得超过PowerBuilder的40个字符限制），并且在Comments框内写出该菜单的作用（中文或英文），如下所示。序号菜单名称Comments 1m_main Front End Main Menu 2m_report Report Subsystem Menu 3m_main_pop主界面的弹出菜

8、单9.函数函数的命名必须符合类型f_subsystemname_detailname或lf_detailname格式，其中gf表示是全局函数，subsystemname是子系统的英文缩写，detailname是与函数意义相关联的英文字母（总长不得超过PowerBuilder的40个字符限制），对于全局函数应该在Comments框内简短写出该函数的作用（中文或英文），如下所示。序号函数名称Comments 1gf_help_index帮助子系统索引全局函数2 lf_get_user_info获取用户信息局部函数3 gf_query_sortbyname查询子系统名排序全局函数10.用户对象用户对

9、象的命名必须以uo（UserObject缩写）开头，加下划线（_），其后紧接与用户对象意义相关联的英文字母（总长不得超过PowerBuilder的40个字符限制），并且在Comments框内写出该用户对象的作用（中文或英文），如下所示序号用户对象名称Comments 1uo_external_function Cross platform user object ancestor 2uo_report_structure User Object as astructure For report 11.控件控件的命名必须以控件名称缩写开头，加下划线（_），其后紧接与控件作用相关联的英文字母（总长

10、不得超过PowerBuilder的40个字符限制），如下所示序号控件名称控件缩写控件命名范例1 CommandButton cb cb_ok 2PictureButton pb pb_thank_info 3CheckBox cbx cbx_age_show 4RadioButton rb rb_typical_setup 5StaticText st st_user_id 6Picture pp_user_photo 7GroupBox gb gb_detail_info 8Line ln ln_h_separator 9Oval oval oval_used_flag 10 Rectang

11、le rr_photo_frame 11 RoundRectangle rr rr_companyflag 12 SingleLineEdit sle sle_user_name 13 MultiLineEdit mle mle_book_comments 14 RichTextEdit rte rte_student_answer 15 EditMask em em_telephone_no 16 HScrollBar hsb hsb_time_set 17 VScrollBar vsb vsb_money_set 18 DropDownListBox ddlb ddlb_your_favo

12、urite 19 DropDownPictureListBox ddplb ddplb_photo_preview 20 ListBox lb lb_department_name 21 PictureListBox plb plb_user_identification 22 ListView lv lv_all_user 23 TreeView tv tv_customers 24 TabPage tpg tpg_ordinary_super 25 Tab tab tab_super 26 DataWindow dw dw_user_info_detail 27 Graph gr gr_m

13、onth_report 28 Ole ole ole_word_doc*变量命名规范变量取名应遵守命名规范，对使用频繁的或关键变量，为了便于阅读和修改，在定义时应加上注释标明其含义。例如：String ls_name/参保人员姓名变量命名规则为：变量范围+变量数据类型+含义代码*变量数据类型约定数据类型前缀Any a_ Blob bb_ Boolean b_ Character c_ Date d_ DateTime dt_ Decimal dec_ Double db_ Integer i_ Long l_ String s_ Time t_ UnsignedInteger ui_ Unsi

14、gnedLong ul_ DataWindow dw_ DataWindowChild dwc_ MailSession ms_ Menu m_ Structure str_ Transacttion trans_ Window w_ UserObject uo_*变量范围命名约定范围字首描述Global g?_全局变量将在整个应用中有效。它们可能从其他对象面板中定义，但它们将在整个应用中有效Shared s?_共享变量在一个对象及其实例中有效Instance i?_实例变量仅在一个对象的实例中有效。相应对象的不同实例中的变量保存各自的值Local l?_局部变量仅在一段子程序或在script

15、开始和结束时生效由值传递的变量v?_在定义函数时，参数仅传递值，不会被函数（仅适用于函数变量）改变，定义为value,例：vdw_datawindow由引用传递的变量r?_在定义函数时，参数将被此函数改变，（仅适用于函数变量）定义为reference，例：rl_long注意：?表示相应数据类型，如i,c,l,s等数据类型前缀。对于上述的内容做如下说明。a.全局变量的命名必须符合gT_subsystemname_detailname格式，其中g表示是全局变量（Globe），T是数据类型（DataType）的简写。subsystename是子系统的英文简写。detailname是有具体意义的英文字

16、母。gs_query_user_info，即为查询子系统定义了一个字符串型全局变量。b.局部变量的命名必须符合lT_detailname格式，其中l表示是局部变量（Local），T是数据类型（DataType）的简写。li_user_salary，即定义了一个整数型局部变量。c.实例变量的命名必须符合iT_detailname格式，其中i表示是实例变量（Instance），T是数据类型（DataType）的简写。Detailname是有具体意义的英文字母。is_product_name，即定义了一个字符串型实例变量。*编程规范*书写格式a.用分层缩进的写法显示嵌套结构的层次。b.在注释段与程序

17、段，以及不同逻辑的程序段之间插入空行。c.每行只写一条语句，当需要滚动显示时应该分行书写。*流控制流控制首先应遵守PowerBuilder语法规范，且用分层缩进的写法突出显示嵌套的层次结构，例如：For i=1 To 100 For j=1 To 50 For k=1 To 200 Matrixi，j，k=1 Next Next Next*注释及格式要求注释总是加在程序中需要概括性说明或不易令人理解或容易令人理解错的地方。注释语言应简练、易懂而又准确，所采用的语种首选是中文，如有输入困难或特殊需求也可采用英文。注释原则：a.函数或过程的注释（1）在函数头部必须说明函数的功能和参数（值参、变参）

18、；（2）在函数的主体部分，如算法复杂时，应以注释的方式对其算法结构做出说明；（3）函数申请过全局资源且有可能导致资源紧张应加以注明（如内存和文件柄等）；（4）函数有副作用一定以十分醒目的方式（如加！号等）注明。b.语句的注释（1）应对不易理解的分支条件表达式加注释；（2）不易理解的循环，应说明出口条件（有GOTO的程序还应说明入口条件）；（3）过长的函数实现，应将其语句按实现的功能分段加以概括性说明。c.常量和变量的注释在常量名声明后应对该名做适当的注释，注释说明的要点是：（1）被保存值的含义（必须）；（2）合法取值的范围（可选）；（3）全局量需要对以上逐点做充分的说明。d.制定对象的注释每个

19、开发人员针对自己所制定的窗口、菜单、数据窗口、数据管道和用户对象等添加注释，要点是：（1）标注对象的用途；（2）标注对象的制定人员；（3）标注时间或者修改时间。具体格式要求如下：1.在窗口Open事件前应说明/*=*/窗口中英文名称：/窗口作用：/作者：/日期：2.在事件脚本（Script）之前应说明/脚本作用：/输入参数及数据类型：/返回参数及数据类型：/全局函数及其用途：/全局变量及其用途：/修改人的姓名：/修改日期：/修改原因：若有多人修改，每个人均加上自己的注释，而不能改他人的姓名、日期、原因，对要修改的脚本，只能注释不能删除，并且在修改的地方加上修改人名、日期和Beginning M

20、odification.，Ending Modification字样。3.脚本中的注释单行脚本程序注释：/注释文本脚本的程序段注释：/*=*/变量的注释如下：数据类型变量名/注释4.在函数、存储过程等脚本（Script）之前应说明/函数名称：/参数解释：/功能描述：/调用举例：/最初作者：/编写日期：/返回值：/变量情况：/修改人：*Powerbuilder脚本编程规范1.Powerbuilder编程注意事项a.不要在子应用中声明全局变量！如必须声明全局变量，则应事先向项目负责人申请。b.供别的文件或函数调用的函数，绝不应使用全局变量交换数据。c.所有SQL语句均需判断返回结果（包括SELEC

21、T，COMMIT语句）。If sqlca.sqlcode=-1 Then错误处理程序跳出Else正常End If d.缺省SQLCA的连接语句connect，在应用Open事件中完成，其disconnect在主应用的Close事件中完成，其余任何pbl中均不能有disconnect语句。e.由于要连接多个数据库，需要用Create创建对象，比如：SQLSYB，则用connect using SQLSYB，处理完毕后用disconnect using SQLSYB，并且用destroy SQLSYB释放资源。2.编码标准（1）在代码块前后留一个空行。例子如下：If condition1 Then

22、 statementblock End If For varname=start To End Step increment statement_block Next（2）把单行注释与当前script程序的缩进位置对齐：/This is acomment For condition1 If condition1 Then/This is acomment For condition2 If condition2 Then/This is acomment For action1 action1 End If End If（3）缩进应以Tab键实现，不得采用空格。（4）变量采用小写格式。变量全部

23、用小写；一个变量一行，每个变量必须注释；通常情况下，变量的后半部分尽量用数据库字段名；变量声明全部在脚本之前声明完毕；所有变量声明时按代码功能段+变量类型进行排序。Long ll_quantity String ls_name对象名采用小写，属性、关键字、保留字和内置函数均用首字母大写格式：w_cont_de.Visible=True m_mdi.m_file.m_print.Enabled=False数据窗口控制的函数加上修饰，而不以数据窗口对象作为参数：dw_main.SetTransObject（sqlca）dw_main.SetRowFocusIndicator（Hand！）dw_ma

24、in.Retrieve（）（5）当连接起来的字符串超过了两行的长度时，使用+符作为下行的第一个字符，每次均采用缩进格式。字符串的随后部分应该再次缩进。ls_msg=连接数据库失败！错误信息为：rn&+Sqlca.SqlErrText&+请与系统管理员联系（6）PowerBuilder保留字（关键字）首字母大写其余小写，这样看起来层次清晰，如：This，Parent，ParentWindow，True，False，Return，Halt与Close。（7）PowerBuilder内部函数及属性每个字首字母大写其余小写，这样看起来层次清晰，如：sle_user.Text，dw_1.SetTrans

25、Object（Sqlca），Sqlca.SqlErrText。（8）SQL语句按如下格式书写：SELECT name，sex，dept_id INTO：ls_name，：ls_sex，：ls_dept_id FROM employee WHERE emp_id=：ls_emp_id；（9）程序中应避免出现goto跳转语句。3.脚本中一些常用功能模块的编程约定（1）光标操作过程的编程约定如下：Declare Cursorname Cursor for Select语句Open Cursorname；fetch Cursorname into variables Do While Sqlca.Sq

26、lcode=0 statementblock fetch Cursorname into variables Loop Close Cursorname光标命名规则：Cur+名称。（2）调用数据库存储过程的编程约定如下：declare Procedurename procedure For StoredProcedureName：Value1，：Value2.；execute Procedurename；fetch Procedurename into variables；close Procedurename；commit；存储过程命名规则：Pro有些系统存储过程（例如：sp_droplog

27、in）不能当做一个事务提交，为了执行它，就必须先置事物对象的AutoCommit属性为True，当存储过程执行完毕后再将事务对象的AutoCommit属性置为False。（3）在每一个SQL语句之后必须判断SQL语句执行成功与否，成功则继续，不成功则做相应处理并给出一条提示信息。If Sqlca.SqlCode 0Then Rollback；MessageBox（错误信息操作失败！Else Commit；提示信息操作成功！End If（4）所有操作符（包括等号）前后应留一空格，使程序看起来更清晰。ls_msg=ls_title+ls_error（5）仅当绝对需要时才在循环结构体中使用函数调用，也就是说，仅当函数的返回值依赖于循环迭代的值时才使用函数调用。使用如下方法：Long ll_num_selected ll_num_selected=lb_devctg.TotalSelected（）For i=1 To num_selectedNext不使用下述方法：For i=1 To lb_1.TotalSelected（）Next 4.PB中的任何一个窗口都要有注释说明一般在窗口的Open事件中对窗口的功能进行全面的介绍，以便维护人员可以很清楚地知道窗口的功能和维护要点。其格式可参见前面的说明。5.表的操作在程序中涉及多个表的操作时，需严格按照各项目组表操作顺序一览表规