PB软件开发规范:命名规则与对象组织

需积分: 0 2 下载量 159 浏览量 更新于2024-09-13 收藏 39KB DOC 举报
"PB命名规则及软件开发规范" 在软件开发过程中,规范是确保团队协作顺畅、代码可读性和可维护性的重要因素。PowerBuilder(PB)作为一种强大的RAD(快速应用开发)工具,同样需要遵循一定的规则和标准来提高开发效率和代码质量。这份文档详细阐述了针对PB的命名规则、库的组织以及对象和变量的命名规范。 1. 应用程序PBL库组成 - Share/PUBLIC.pbl:存储应用级、菜单、通用函数和公共结构。 - app_win.pbl:存放窗口对象。 - app_dat.pbl:用于数据窗口对象。 - Control.pbl:包含可重用的用户对象。 在实际情况中,考虑到窗口和数据窗口对象数量较多,可以按照系统大菜单功能来命名和组织PBL库,而不是严格按照上述分类。 2. 对象命名规范 - 窗口命名:以w_开头,后面接描述窗口功能的英文单词,例如w_label表示标签窗口。如果一个窗口是另一个窗口的弹出窗口,可以在末尾附加_pop,如w_label_pop。 - 数据窗口对象命名: - 报表:d_模块功能名 - 子报表:dwc_模块功能名 - 查找条件数据窗口:dwf_模块功能名 - Windows窗口内数据窗口:dw_模块功能名 - Datastore对象:ds_模块功能名 - 下拉列表框数据窗口:dddw_模块功能名 - 数据源通常是表名,例如d_stv_class对应表stv_class。 3. 变量命名规范 - 全局变量:以gt_开头,后跟变量类型首字母,然后是功能描述,如gt_iCounter。 - 实例变量:以类似的方式命名,如iv_strName。 4. 注释规范 - 明确、简洁的注释有助于理解代码功能,应该在每个对象和函数开始处提供描述。 - 注释应使用标准格式,如C++风格的//单行注释或/*...*/多行注释。 5. 代码格式规范 - 保持代码缩进一致,通常使用4个空格或一个Tab。 - 函数和方法的定义应清晰,参数列表以逗号分隔,每行不超过一定长度,避免过长的单行代码。 - 使用空行分隔逻辑相关的代码块。 6. 界面规范 - 界面设计应遵循易用性和一致性原则,控件布局合理,颜色搭配协调。 - 控件命名应反映其功能,例如lbLabel、btButton等。 通过遵循这些规范,开发者可以更容易地理解和维护代码,同时减少潜在的错误和混乱。良好的编程习惯不仅可以提高工作效率,也有利于团队合作,使项目更加健壮和易于扩展。