分享
 
 
 

蛙蛙推荐:PB开发规范.doc

王朝delphi·作者佚名  2006-01-09
窄屏简体版  字體: |||超大  

我的使用小得是:

1。每个表都用中文注明,这个表的标题,表中所有字段的内容。

2。 窗口,数据窗口,事件,类也都注明。

我的PBL是根据所要涉及的模块化分,我个人认为适合我的开发风格。:)

其他是每次使用内存后,在处理完后就释放。(如:datastore)

打开pb 的同时,打开word,把你作的改动,你遇见和解决的问题记录下来(代码和文档同步!)

在每一个pbscript的开始要写出注释,功能,作用之类的注释

PowerBuilder程序开发规范

一、 系统对象的命名

对象名称 命名规则

窗口(WINDOW) w_name

菜单(MENU) m_name

用户对象(USER OBJECT) uo_name

结构体(STRUCTURE) s_name

函数(FUNCTION) f_name

数据窗口(DATA WINDOW)普通数据窗口下拉式数据窗口 (用于DropDwon Datawindow) d_name dddw_name

管道(PIPELINE) p_name

二、 窗口控件命名

控件名称 命名规则

命令按钮(COMMANDBUTTON) cb_name

图形按钮(PICTUREBUTTON) pb_name

复选框(CHECKBOX) cbx_name

单选框(RADIOBOX) rb_name

静态文本(STATICTEXT) st_name

图片(PICTURE) p_name

分组框(GROUPBOX) gb_name

线条(LINE) ln_name

单行编辑框(SINGLELINEEDIT) sle_name

格式编辑框(EDITMASK) em_name

多行编辑框(MULTILINEEDIT) mle_name

RICHTEXTEDIT 控件(RICHTEXTEDIT) rte_name

水平滚动条(HSCROLLBAR) hsb_name

竖直滚动条(VSCROLLBAR) vsb_name

下拉列表框(DROPDOWNLISTBOX) ddlb_name

下拉图形列表框(DROPDOWNPICTURELISTBOX) ddplb_name

列表框(LISTBOX) lb_name

图形列表框(PICTURELISTBOX) plb_name

ListView控件(LISTVIEW) lv_name

TreeView控件(TREEVIEW) tv_name

Tab控件(TAB)Tab页 tab_name tabpage_name

数据窗口控件(DATAWINDOW) dw_name

图形控件(GRAPH) gr_name

OLE控件 ole_name

用户对象控件(USER OBJECT) uo_name

变量命名

变量类型 命名规则

布尔型变量(BOOLEAN) Xb_name

字符型变量(CHAR) Xc_name

日期型变量(DATA) Xd_name

日期时间型变量(DATATIME) Xdt_name

小数型变量(DECIMAL) Xdec_name

双精度浮点型变量(DOUBLE) Xdou_name

整型变量(INTEGER) Xi_name

长整型变量(LONG) Xl_name

实型变量(REAL) Xr_name

结构体变量(STRUCTURE) Xstr_name

字符串型变量(STRING) Xs_name

时间型变量(TIME) Xt_name

无符号整型变量(UINT) Xui_name

无符号长整型变量(ULONG) Xul_name

说明:对于变量的命名规则中的X

全局变量(GLOBAL VAR) X用g替换

实例变量(INSTANCE VAR) X用i替换

共享变量(SHARED VAR) X用s替换

局部变量(LOCAL VAR) X用l替换

例如:定义字符串变量

全局变量(GLOBAL VAR) gs_name

实例变量(INSTANCE VAR) is_name

共享变量(SHARED VAR) ss_name

局部变量(LOCAL VAR) ls_name

定义整型变量

全局变量(GLOBAL VAR) gi_name

实例变量(INSTANCE VAR) ii_name

共享变量(SHARED VAR) si_name

局部变量(LOCAL VAR) li_name

三、 其他命名

名称 命名规则

用户自定义事件(USER EVENT) ue_name

窗口函数(WINDOW FUNCTION) wf_name

我的思想:多用封装的,少写代码!

一个人写的代码也许只有他自己才能读的懂!

l 建议在本机上建rubbish目录,用来存放暂时不用但以后有可能用到的东西。

l 注意使用已有的类。以继承方式用之。禁止不查看已有的类,自己又重做一套。

l share中各对象都应注册到版本控制系统,如ObjectCycle,修改对象时使用checkin/checkout机制,以便两个/多个人可共同维护同一组对象而不发生冲突,最主要的是可保存以前任何版本,便于提交和恢复

。新建对象时,首先想到的应当是“inherit”,而不是“new”!

l PBL命名规则为以模块标识打头如:jl_。

l 每个pbl模块不应大于1.5MB,过大则应再划分

一、 引言

为了规范软件开发代码及文档,方便维护,特制定软件开发规范如下。

二、 文档编写要求

每个系统要求有:需求分析文档、需求变更文档、数据库结构文档、数据库变更文档、软件开发文档。文档应先于具体编程,即编写程序以前必须写好相应的文档,然后按照文档进行编程。

每个窗口、事件都必须有文档。要求写出模块的名称、功能、输入、输出参数介绍、创建、修改时间。

三、 程序风格

程序要有良好的缩进格式。以Power Builder为例:

If condition Then

something to do

End If

即每个关键字头字母大写,相应位置有3个空格的缩进。

四、 变量命名规范(以Power Builder为例)

1、 对象命名

PowerBuilder中,对象的命名一般采用如下前缀:

Prefix Object

-------------------------------------------

d_ DataWindows

dddw_ DropDownDataWinows

f_ Functions

m_ Menus

p_ Pipelines

s_ Structures

u_ UserObjects

w_ Windows

2、 控件命名

在PowerBuilder的窗口中,控件的命名一般采用如下前缀:

Prefix Control

---------------------------------------------------------------

cbx_ CheckBox

cb_ CommandButton

dw_ DataWindow

ddlb_ DropDownListBox

em_ EditMask

gr_ Graph

gb_ GroupBox

hsb_ HScrollBar

ln_ Line

lb_ ListBox

mle_ MultiLineEdit

ole_ OLE 2 0

ocx_ OCX

oval_ Oval

p_ Picture

pb_ PictureButton

rb_ RadioButton

r_ Rectangle

rr_ RoundRectangle

sle_ SingleLineEdit

st_ StaticText

uo_ User Object

vsb_ VScrollBar

3、 变量命名:

---------------------------------------------------------------

1)、作用域命名

Prefix Scope

---------------------------------------------------------------

g_ Global

s_ Shared

i_ Instance

l_ Local

2)、变量类型前缀

Prefix Datatype

---------------------------------------------------------------

b_ Boolean

blob_ Blob

d_ Double

date_ Date

dec_ Decimal

dt_ DateTime

i_ Integer

l_ Long

s_ String

t_ Time

ui_ Undisgned Int

ul_ Undisgned Long

tr_ Transaction object

do_ Dragobject

dwc_ DataWindowChild

nvo_ NonVisulObject

4、 函数命名

Prefix Scope

---------------------------------------------------------------

gf_ Global Function

wf_ Window Function

mf_ Menu Function

uf_ UserObject Function

五、 程序注释要求

要求每个事件、函数、变量等都必须有注释。注释与代码的比例最少应达到1:3。

事件、函数代码开头注释模版为:

/**********************************************************************************

功能:

参数:

返回:

作者:

创建: 1999.09.21

修改: 2000.09.21 **********************************************************************************/

//////////////////////////////////////////////////////////////////////////////

//

// Function: of_UpdateChecks

//

// Access: protected

//

// Arguments:

// apo_control[] The array of object for which the checks need to be

// performed.

//

// Returns: integer

// 1 = updates were found

// 0 = No changes to update were found

// -1 = AcceptText error

// -2 = UpdatesPending error was encountered

// -3 = Validation error was encountered

//

// Description: Perform accepttext, updatestpending and validation on

// the objects.

//

//////////////////////////////////////////////////////////////////////////////

在每段程序的前方写明代码的作用、逻辑等。每个变量要求写出其功能。

六、 对象的命名及备注

每个对象备注中要有对象的功能及开发人。

我认为这样挺规范的:

一、变量规范

1、前缀

(1)、作用域

全局(Global): g

共享(Shared): s

实例(Instance): i

局部(Local): l

(2)、类型

b Boolean

blob Blob

d Double

num Number

date Date

dec Decimal

dt DateTime

i Integer

l Long

s String

t Time

ui Undisgned Int

ul Undisgned Long

tr Transaction Object

do DragObject

ds DataStore

dwc DataWindowChild

nvo NonVisulObject

tri TreeViewItem

lvi ListViewItem

2、格式

作用域 类型 _ 英文意义或缩写

首字母大写 首字母大写或全部大写(缩写)

注:不可随意定义或更改全局变量

二、PowerBuilder对象

1、窗口(Window)

w _子模块拼音码_功能或用途(英文意义)

2、数据窗口(DataWindow)

d_子模块拼音码_功能或用途(英文意义)

3、查询(Query)

q_子模块拼音码_功能或用途(英文意义)

4、数据管道(Pipeline)

p_子模块拼音码_功能或用途(英文意义)

5、函数(Function)

f_子模块拼音码_功能或用途(英文意义)

6、全局函数(Global Function)

gf_功能或用途(英文意义)

7、窗口函数(Window Function)

wf_功能或用途(英文意义)

8、菜单函数(Menu Function)

mf_功能或用途(英文意义)

9、用户自定义对象函数(User Object Function)

uf_功能或用途(英文意义)

10、菜单(Menu)

m_子模块拼音码_功能或用途(英文意义)

11、结构(Structure)

stru_子模块拼音码_功能或用途(英文意义)

12、用户自定义对象(User Object)

u_子模块拼音码_功能或用途(英文意义)

13、控件(Controls)

cbx_ CheckBox

cb_ CommandButton

dw_ DataWindow

ddlb_ DropDownListBox

em_ EditMask

gr_ Graph

gb_ GroupBox

hsb_ HScrollBar

ln_ Line

lb_ ListBox

mle_ MultiLineEdit

ole_ OLE 2 0

ocx_ OCX

oval_ Oval

p_ Picture

pb_ PictureButton

rb_ RadioButton

r_ Rectangle

rr_ RoundRectangle

sle_ SingleLineEdit

st_ StaticText

uo_ User Object

vsb_ VscrollBar

特别说明:

系统固定按钮名称

Cb_Yes [是(&Y)]

Cb_No [否(&N)]

Cb_Ignore [忽略(&I)]

Cb_Retry [重试(&R)]

Cb_Abort [终止(&A)]

Cb_Ok [确定(&Y)]

Cb_Cancel [取消(&C)]

Cb_Return [返回(&R)]

Cb_Close [关闭(&X)]

Cb_Print [打印(&P)]

Cb_PrintPrev [打印预览(&V)]

Cb_Gen [生成(&G)]

Cb_Query [查询(&Q)]

Cb_Count [统计(&T)]

Cb_Add [添加(&A)]

Cb_Insert [插入(&I)]

Cb_Del [删除(&D)]

Cb_Modify [修改(&M)]

Cb_Save [保存(&S)]

Cb_Send [发送(&F)]

Cb_Audit [审核(&T)]

Cb_Abandon [作废(&Z)]

Cb_First [首条]或[9]Webdings字体

Cb_Next [后一条]或[8]Webdings字体

Cb_Prev [前一条]或[7]Webdings字体

Cb_End [末条]或[:]Webdings字体

三、PowerBuilder库文件

每个子模块包含有最多10个Pbl文件,其中有:

1、存放子模块所使用的PowerBuilder基本对象(窗口、菜单等):

子模块拼音码+序号(00 - 09).pbl -- 10个

2、存放子模块所使用的资源文件(Bmp、Ico、Cur、Ani文件)

子模块拼音码+Res.pbl -- 1个

四、代码

Powerbuilder中的保留字首字大写

内嵌式SQL语句保留字全部大写

自定义函数注释格式:

名称:

功能:

参数:

逻辑:

适用:

编程:

创建: 2002.01.01

修改: 2002.02.01

版本: 1.0

在重要或复杂的逻辑代码前一行须加上注释,格式如下:

//注释内容 – 程序员姓名

……

代码

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
2023年上半年GDP全球前十五强
 百态   2023-10-24
美众议院议长启动对拜登的弹劾调查
 百态   2023-09-13
上海、济南、武汉等多地出现不明坠落物
 探索   2023-09-06
印度或要将国名改为“巴拉特”
 百态   2023-09-06
男子为女友送行,买票不登机被捕
 百态   2023-08-20
手机地震预警功能怎么开?
 干货   2023-08-06
女子4年卖2套房花700多万做美容:不但没变美脸,面部还出现变形
 百态   2023-08-04
住户一楼被水淹 还冲来8头猪
 百态   2023-07-31
女子体内爬出大量瓜子状活虫
 百态   2023-07-25
地球连续35年收到神秘规律性信号,网友:不要回答!
 探索   2023-07-21
全球镓价格本周大涨27%
 探索   2023-07-09
钱都流向了那些不缺钱的人,苦都留给了能吃苦的人
 探索   2023-07-02
倩女手游刀客魅者强控制(强混乱强眩晕强睡眠)和对应控制抗性的关系
 百态   2020-08-20
美国5月9日最新疫情:美国确诊人数突破131万
 百态   2020-05-09
荷兰政府宣布将集体辞职
 干货   2020-04-30
倩女幽魂手游师徒任务情义春秋猜成语答案逍遥观:鹏程万里
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案神机营:射石饮羽
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案昆仑山:拔刀相助
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案天工阁:鬼斧神工
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案丝路古道:单枪匹马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:与虎谋皮
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:李代桃僵
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案镇郊荒野:指鹿为马
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:小鸟依人
 干货   2019-11-12
倩女幽魂手游师徒任务情义春秋猜成语答案金陵:千金买邻
 干货   2019-11-12
 
推荐阅读
 
 
 
>>返回首頁<<
 
靜靜地坐在廢墟上,四周的荒凉一望無際,忽然覺得,淒涼也很美
© 2005- 王朝網路 版權所有