格式规范:
1、TAB空格的数量。编辑器上的TAB空格数量统一取值为4
2、换行,
每行120字符
3、if语句的嵌套层数3层以内
4、匿名内部类20行以内 ,太长的匿名内部类影响代码可读性,建议重构为命名的
(普通)内部类。
5、文件长度2000行以内
6、方法长度150行以内
7、逻辑上相关序代码与其前后之程序代码间应以空白行加以分隔;在注释段与程序
段、以及不同程序段插入空行。提高可读性
8、方法(构造器)参数在5个以内 ,太多的方法(构造器)参数影响代码可读性。
考虑用值对象代替这些参数或重新设计。
9、CC 度量值不大于10
解释:CC(CyclomaticComplexity)圈复杂度指一个方法的独立路径的数量,可以
用一个方法内if,while,do,for,catch,switch,case,?:语句与&&,||操作符的
总个数来度量。
10、NPath度量值不大于200
解释:NPath度量值表示一个方法内可能的执行路径的条数。
11、布尔表达式中的布尔运算符(&&,||)的个数不超过3个
命名规范:
(开发人员如果遇到以下未列举的类型,请书面通知相关管理人员,由管理人员集中更新列
表内容,不得擅自启用未经确定的新变量前缀)
包名必须全部用小写。
命名方式:业务领域名.子系统名.层名 如com.iteach.dao.weibo
类名以英文单词取名,首字母必须大写,多个英文单词以大写字母间隔,避免使用单词的缩写,除非它的缩写已经广为人知,如HTTP。类名中不允许'_'、 '-'等符号。
属性在类定义的开始,按照public,protected,package,private顺序放置。定义local变量尽量在那段代码的开始处,如方法的开始处。
如果是if,for,while段,尽量在左大括号"{"的下一行处定义要使用的local变量。
尽量用相同含义英文单词表示,不允许'_'、 '-'等符号,如:custName。第一个字母小写,中间单词的第一个字母大写。不要用_或&等符号作为第一个字母。单字符的变量名一般只用于生命期非常短暂的变量。如:i,j,k,m,n一般用于int。如果变量是集合,则变量名应用复数,即以小写s结尾 。例如:
序号
变量名称
注
释
1
strFileName
"文件名"字符串类型
2
intFileCount
"文件总数"整型
3
strFames
多个"文件名"的集合
4
gMemory
全局变量
常量名均全部大写,单词间以'_'隔开。例如:
序号
常量名称
注释
1
MAX_NUM
最大数
2
public static final String FUNCTION_LIST =
"function_list";
…
方法命名采用"动作+属性"
的方法。并且,动作以小写字母开始,属性以大写字母开始。常用的动作有:is、get、set、add、
update、del等。
例如:getName、setName、isSysManager、saveXXX、mdfXXX、delXXX等。
规则名称
规则
说明
新增数据
addXXX
修改数据
updateXXX
删除数据
deleteXXX
查询数据
findXXX
getXXX
findUserByName() 获取单个
getUserByName()
获取所有
备注:
遇到缩写如XML时,仅首字母大写,即loadXmlDocument()而不是
loadXMLDocument()
为了基于接口编程,不采用首字母为I或加上IF后缀的命名方式,如
IBookDao,BookDaoIF。
页面部件名建议命名为:btnOK、lblName或okBtn、nameLbl
其中btn、lbl缩写代表按钮(Button)、标签(Label)。
注释规范:
(在类、方法开始之前需要添加中文注释,类和方法的注释采用Java自动生成的注释格式。)
1、类注释:
2、函数注释
3、程序段注释
如果做过修改需加上修改者和日期//修改者 修改日期 说明
或者
4、变量或属性注释
//说明
5、失效代码注释
由界定,标准的C-Style的注释,专用于注释已失效的代码
注:没有意义的注释语句删掉,不留空的注释语句
备注建议的注释:(非下划线标注的规范建议使用,不强制)
循环语句和判断语句前必须注释。
特殊变量声明时需要注释。
如果方法允许Null作为参数,或者允许返回值为Null,必须在JavaDoc中说明。
注释中的第一个句子要以(英文)句号、问号或者感叹号结束。Javadoc生成
工具会将注释中的第一个句子放在方法汇总表和索引中。
为了在JavaDoc和IDE中能快速链接跳转到相关联的类与方法,尽量多的使用
@see xxx.MyClass,@see xx.MyClass#find(String)。
如果注释中有超过一个段落,用
分隔。
示例代码以
包裹。
标识(java keyword,
class/method/field/argument名,Constants) 以
包裹。
标识在第一次出现时以{@linkxxx.Myclass}注解以便JavaDoc与IDE中可以链
接。
如果该注释是废话,连同标签删掉它,而不是自动生成一堆空的标签,如空的
@param
name,空的@return。
推荐的注释内容:
对于API函数如果存在契约,必须写明它的前置条件(precondition),后置条件
(postcondition),及不变式(invariant)。
对于调用复杂的API尽量提供代码示例。
对于已知的Bug需要声明。
在本函数中抛出的unchecked exception尽量用@throws说明。
代码质量不好但能正常运行,或者还没有实现的代码用//TODO: 或//XXX:
声明存在错误隐患的代码用//FIXME:声明
异常处理:
重新抛出的异常必须保留原来的异常,即throw new NewException("message",
e);
而不能写成throw new
NewException("message")。
在所有异常被捕获且没有重新抛出的地方必须写日志。
如果属于正常异常的空异常处理块必须注释说明原因,否则不允许空的catch块。
框架尽量捕获低级异常并封装成高级异常重新抛出,隐藏低级异常的细节,方便
系统能够更好的跟踪运行情况。
如果一个层要抛出多个异常,那么所有自定义异常必须统一继承一个父类异常。
这样上层可以通过父类异常捕获。
编写细节建议规范:
1、
为了提高可读性,一般情况下,字符串的连接使用"+",而不是StringBuffer
中的方法。在考虑速度性能的时候才考使用StringBuffer。
2、
(不强制)没有特殊原因,不要定义synchronized 的方法。而是在方法内实
际需要同步的代码段加入synchronized限定,如:
public void sharedMethod() {
String display = null;
synchronized( this ) {
display = mySharedObject.getHelloWorld();
}
System.out.println( display );
}
3、
捕捉例外的标准书写规则如下:
try{
// some stuff
} catch ( FileNotFoundException fnfe )
{
// some stuff
} finally {
// some stuff
}
例外的变量名统一规定为例外类名中大写字母的组合。
4、
(不强制)对于一个方法或实例化类调用是否成功,不采用返回boolean值来判
断,而采用捕捉例外的方法,如:
Order m_order = new Order();
try {
m_order.init();
} catch ( OrderNotFoundException onfe )
{
// some stuff
}