锁定老帖子 主题:程序编写规范及操作
精华帖 (0) :: 良好帖 (0) :: 灌水帖 (0) :: 隐藏帖 (14)
|
|||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
作者 | 正文 | ||||||||||||||||||||||||
发表时间:2010-05-13
最后修改:2010-10-11
一、数据库的命名表的命名: tg_ 表功能名词 _info( 主表 ) tg_ 表功能名词 _ 其他修饰词 ( 副表,扩展表 ) 视图的命名: vg_ 表功能名词 _info 序列的命名: seqg_ 表功能名词 _id 存储的命名: pg_ 功能修饰 函数的命名: fg_ 功能修饰 二、包、类和方法的命名a) 包的命名
表和模块的对应关系会在设计说明书中说明。 b) 类和方法的命名类的命名参照 java 命名规范中的要求 : 类,接口:由一个或几个单词组成,每个单词的第一个字母大写,比如: StringBuffer 类:一般用名词和名词词组命名 ; IndexOptimizer.java; WebDbReader.java 接口:与类相同,可以使用形容词词缀,比如 Runnable, Comparable 方法:除第一个字母小写外,和类,接口的命名规则一样。比如: getPersonInfo() 对于取属性值和设置属性值的方法:不管是否是 Bean ,都要遵循 JavaBean 命名规范: getXXX(), setXXX() 转换对象类型返回不同类型的方法:命名成 toType ,比如: toString(), toArray() 返回视图的方法:命名成 asType() 形式, asList() 返回与调用此方法的对象( Wrapper Class )同值的原始类型的方法:命名成 typeValue() 形式,比如 intValue(), floatValue(),parseCharacterEncoding(String); 注:需要遵循,类的用途,通常将用途或功能相近的类放置在一起,命名为类主要解决的问题简单表述。只要其他操作人员在看到该类的时候通过名字大概可以知道该类处理那些问题。 三、 Ext 、 Jsp 和 js 的命名A 、 EXT 编码: 一、 目录管理 1 、 Ext 支持文件目录: .\widgets\ext-3.1.0 标明目前所使用 EXT 版本 Ext3.1.0 ┠ ------extend 扩展 Ext 文件目录 ┠ ------resources Ext 资源文件目录( images 、 css ) 2 、各业务模块 JS 文件目录: .\jscript\g3 ┠ ------qq qq JS 文件目录 ( 具体相关业务 ) ┠ ------bas 应用认证 ( 具体相关业务 )
二、 命名约定 1 、 业务模块 JS 文件命名,相对应具体表操作以表名 ( 小写字母 ) 作为文件名,如操作用户的 JS 文件为 bas_member.js 。 2 、 所有业务 JS 文件中出现的 re_ 、 ds_ 、 cm_ 、 btn_ 、 grid_ 、 win_ 、 frm_ 、 fun_ 、 panel_ 等均不可重名,其命名需加入表名信息,如 bas_member.js 中命名为: re_member 、 ds_member 、 btn_search_member 、 btn_add_member 等。 3 、 业务 JS 文件中按钮 handler 下函数命名同样需加入表名信息,与按钮命名保持对应。 4 业务 JS 文件中查询条件名称同样不可重复,如 bas_member.js 中按姓名查询写法为: ‘姓名:’ new Ext.form.TextField({id:'member_mcsearch',name:' member_mcsearch ',width:100} 传入 ds 写法为: grid_member.getStore().baseParams.mcsearch =Ext.getCmp("member_mcsearch").getValue(); 四、书写注释 定义这个规范的目的是让项目中所有的文档都看起来像一个人写的,增加可读性,减少项目组中因为换人而带来的损失。(这些规范并不是一定要绝对遵守,但是一定要让程序有良好的可读性)。 建议在方法中的逻辑处填写必要的注释,说明问题的解决流程。 五、第三方包的管理在系统中如需引用到第三方包,首先查看《第三方包管理文档》中是否存在记录,如管理文档中没有,需在《第三方包管理文档》中登记后使用。包的版本由记录人管理维护。以避免包冲突的发生。 六、配置文件管理在系统中存在多种配置文件,主要为两种: 一、系统配置文件:系统参数配置文件、数据库配置文件 二、框架配置文件: struts 配置文件、 spring 配置文件、 ibatis 配置文件等。 在系统配置文件中需对配置参数加以说明注释,框架配置文件中尽量分类、有序,以便他人添加配置。 七、团队关于代码的维护规范团对中的成员对代码的整体维护,在保证代码编译成功的情况下,在离开公司前提交程序到服务器,上班时先获取最新的程序代码后再开始工作。 a) 帮助文件为能够团队有效的相互协调工作,会不定期的提供代码或外部工具包的帮助手册,作为技术开发文档,团队成员可以了解系统中已有的功能,方法中已有的可重用的则不重新编码,减少开发量,降低代码的维护难度。 b) 类的维护类的书写人可以新增,修改,删除该类的方法,其他团队成员在开发中出现的新的功能需求,需要在某个类中添加或修改,需联系该类的书写人维护。这样可以保证代码的准确性。不要随便修改他人代码。 如果类中的方法在系统中已取消使用,则在通知书写人确认后转入 back 包中,以备以后使用。 c) svn开发中的代码是以服务器上 ( 现在服务器是在内网 ip : 67) 的为准,不能提交有问题的代码。代码提交要及时,准确。在代码提交后要告知小组开发成员,以便能及时获取最新代码。 八、数据库的维护在开发中数据库是测试的基础。对在测试过程中产生的测试数据,在测试完毕后须及时删除。
声明:ITeye文章版权属于作者,受法律保护。没有作者书面许可不得转载。
推荐链接
|
|||||||||||||||||||||||||
返回顶楼 | |||||||||||||||||||||||||
发表时间:2010-05-14
最后修改:2010-05-14
我看一份编程规范是否有实际意义时,只查看一个指标,“单个方法可以最多能写多少行程序”。
|
|||||||||||||||||||||||||
返回顶楼 | |||||||||||||||||||||||||
发表时间:2010-05-17
tuti 写道 我看一份编程规范是否有实际意义时,只查看一个指标,“单个方法可以最多能写多少行程序”。
然也。从这个指标的值可以看出一个公司的编程水平。 |
|||||||||||||||||||||||||
返回顶楼 | |||||||||||||||||||||||||
浏览 2900 次