hbh 开发规范文档
一:目的
使本组织能以标准的,规范的方式设计和编码。通过建立编码规范,以使每个开发人员
养成良好的编码风格和习惯;并以此形成开发小组编码约定,提高程序的可靠性,可读性,
可修改性,可维护性和一致性等,增进团队间的交流,并保证软件产品的质量。
二:代码组织与风格
1:长度:为便于阅读和理解,单个函数的有效代码长度当尽量在100行以内(不包括注行),
当功能模块过大时往往采用使用子函数将相应的功能抽取出来,这也有利于提高代码的重用度。
2:间隔:类,方法及功能块间等应以一个空行相隔,以增加可读性,但不得有无规则的大片空行。操作符两端应当各空一个字符以增加可读性。
三:注释
1:注释应该增加代码的清晰度。代码注释的目的时要使代码更易于被其他开发人员等理解。
2:保持注释的简洁。
3:注释信息应该包括代码的功能。
4:除变量定义等较短语句的注释使用行尾注释外,其他注释当避免使用行尾注释
5:JavaDoc规范
对类,方法,变量等注释需要符合
javadoc规范,对每个类,方法都应详细说明其功能条件,参数等。
1)类,接口注释
在类,接口定义之前当对其进行注释,包括类,接口的目的,作用,功能,继承于何种父类,实现的接口,实现的算法,使用方法,示例程序等。
2)方法注释
以明确该方法功能,各参数含义以及返回值等。
3)其他注释
应对重要的变量及不易理解的分支条件表达式加以注释,以说明其含义等。
四 命名规范
1:对变量,类,接口及包的命名应该使用英文或者是汉语首字母。更不可以使用汉字来进行命名。采用大小写混合,提高名字的可读性。一般应该采用小写字母,但时类和接口的名称的首字母,以及任何中间单词的首字母应该大写。包名全部小写。
2:尽量少用缩写,但如果一定要用,当使用公共缩写和习惯缩写等,如implement可缩为impl,manager可缩写成mgr等。
3:包名一般以项目或模块名命名,少用缩写和长名,一律小写。包名按照如下规定组成[基本包].[项目名].[模块名].[子模块名].…. 如:org.skyinn.skyhome.dao.hibernate。 不得将类直接定义在基本包下,所有项目中的类,接口等都当定义在各自的项目和模块包中。
4:类,接口
所有单词首字母大写,最好能够见名知意。一般采用名词或者是汉语首字母。或able,dao,dto,bean后缀。
5:字段
常量采用完整的英文大写单词,单词之间用下划线连接,如DEFAULT_VALUE.
6:变量和参数对不易识别出该变量类型的变量应使用类型缩写作其前缀,如字符串使用strXXX,boolean使用isXXX,hasXXX等等。除第一个单词外其余单词的首字母大写。
7:集合
采用复数名称来表示队列中存放的对象类型,名词采用完整的英文描述。例如:Vector vProducts= new Vector(); Array aryUsers= new Array();
8:方法
方法的名称应采用完整的英文描述,大小写混合使用:所有中间单词的第一个字母大写。方法名称的第一个单词常常采用一个强烈动作色彩的动词。取值类使用get前缀,设置类使set
前缀。例如getName(),setSarry()。
9:异常类名由表示该异常类型的单词和Exception组成,如ActionException。异常实例一般使用e,ex等。
10:数组的命名
数组应该总是用下面的方式来命名:byte[] buffer; 而不是:byte buffer[];
关于hbh项目的特殊规定:
一.controller层规范:
1.在controller层中查询类接口全部以quary*开头。查询本地使用quaryList。查询中登quaryZdList。
2. 在controller层提交类接口全部以to*开头。查询本地使用toZzh。
3. url地址一般是以方法名称。如果有特殊情况。与本规范作者沟通。并且添加到此规范中。