CheckStyle代码开发规范.docx

《CheckStyle代码开发规范.docx》由会员上传分享，免费在线阅读，更多相关内容在应用文档-天天文库。

1、一、JavaDoc注释1.类和接口的javadoc添加类和接口的javadoc，指明该类的大体功能2.方法的javadoc添加方法javadoc，并且对参数进行说明二、命名约定检查范围约束的值package名首字母小写，以小写字母，数字组成类型(Class或Interface)名首字母大写，以大写字母，小写字母，数字组成方法名首字母小写，以大写字母，小写字母，数字组成。方法命名需要以动词开头。publicvoidaddKeyAttribute(Stringattribute){}如返回类型为boolean型，则用is开头publicb

2、ooleanisLogin(Stringusername);方法中的参数名首字母小写，以大写字母，小写字母，数字组成常量(static,final字段)首字母大写，以大写字母，数字，下划线组成。建议每个音节下划线分割，并且有staticfinal资源。privatestaticfinalStringKEY_MODEL_CODE=”code”变量首字母小写，以大写字母，小写字母，数字组成三、Imports1.import中避免星号"*"避免出现importa.b.*2.没用的import以下几种import是没用/没意义的：·没有被用到

3、。·重复的。·importjava.lang的。·import与该类在同一个package的。四、长度限制1.文件长度文件的行数不超过15002. 每行长度一行的长度不超过120个字母3. 方法长度一个方法最多的行数为50行，不包括空白和注释4. 方法的参数个数方法的参数不超过5个五、关键字1. 关键字的出现顺序每个关键字都有正确的出现顺序。比如publicstaticfinalXXX是对一个常量的声明。如果使用staticpublicfinal就是错误的。六、对区域(emptyblock)的检查1. 空白区域只要是{}包含起来的，都

4、是区域。比如if,else,catch后面紧跟的，都是区域。不允许后面有空格，减少文件大小2. 需要括号的区域比如，只有一条语句的if，对于大括号是可用可不用的if(condition)a=0;应该用{}，养成良好的编码习惯3. 不必要的括号比如，这样的代码是可以通过编译，但是风格很差的：publicvoidguessTheOutput(){intwhichIsWich=0;{intwhichIsWhich=2;}System.out.println("value="+whichIsWhich);}七、编码的检查1. 字符串(Stri

5、ng)的比较检查字符串的比较时没有使用==或!=。2.不合理的throws方法抛出异常时，不要使用不能throwsjava.lang.Exception，要明确抛出的异常。3.变量初始化声明一个变量，要初始化，如：Strings=null;不要Strings;即使java有默认值4.switch不能丢了default分支switch最好别用。因为用了必须要有default分支才能逻辑正确。否则的话，编译不报错。但是运行起来会报错（把所有的case依次执行一遍）。5.switch语句的default位置排在最后确保switch语句的de

6、fault一定在最后出现。虽然java语法允许default可以放在switch中的任何位置，但是把它放在各个case的最下面是可读性最强的。6.switch中错误分支检查每个switch只执行一个分支。也就是说，检查某个case中是否有break,return,throw或continue语句。7.同一行禁止声明多个变量确保每行只声明一个变量。八、复杂度 函数的复杂度函数的分支复杂度，不超过7。确保函数的分支复杂度没有超出限制。该复杂度是通过考察大部分函数（构造函数，一般方法，静态初始函数，实例初始化函数）中的if,while,do

7、,for,?:,catch,switch,case语句和&&,

8、

9、的操作符的数目来计算得到的。它表示了通过一个函数的最少分支数，也因此体现了需要进行的测试数目。一般而言1-4是优秀，5-7是合格。8-10看情况重构。11个以上一定要马上重构！九、杂项1.大写的L检查并确保所有的常量中的L都是大写的。也就是在常量中没有使用”l”而是用的”L”，比如long型常量，都要以”L”结尾。这与Sun编码规范 3.10.1相一致。小写的字母l跟数字1太象了。2.声明数组的风格检查数组类型的定义。有两种风格：java风格的：String[]args

10、或者C/C++风格的：Stringargs[]。请使用java风格。3.翻译属性文件为了保证翻译的正确性而检查所有的属性文件(propertiyfiles)的键(key)是否一致。如果两个属性文件描述的是同一个东东的不同