checkStyle配置说明、范例和结果分析

最新推荐文章于 2024-06-17 18:03:48 发布
最新推荐文章于 2024-06-17 18:03:48 发布
阅读量4k 收藏 4
点赞数

checkStyle配置说明、范例和结果分析

  1 <? xml version="1.0" ?>
  2 <! DOCTYPE module PUBLIC
   3     "-//Puppy Crawl//DTD Check Configuration 1.2//EN"
   4     "http://www.puppycrawl.com/dtds/configuration_1_2.dtd" >
  5
  6 <!--
  7
  8   Checkstyle configuration that checks the sun coding conventions from:
   9
 10     - the Java Language Specification at
  11       http://java.sun.com/docs/books/jls/second_edition/html/index.html
  12
 13     - the Sun Code Conventions at http://java.sun.com/docs/codeconv/
  14
 15     - the Javadoc guidelines at
  16       http://java.sun.com/j2se/javadoc/writingdoccomments/index.html
  17
 18     - the JDK Api documentation http://java.sun.com/j2se/docs/api/index.html
  19
 20     - some best practices
  21
 22   Checkstyle is very configurable. Be sure to read the documentation at
  23   http://checkstyle.sf.net (or in your downloaded distribution).
  24
 25   Most Checks are configurable, be sure to consult the documentation.
  26
 27   To completely disable a check, just comment it out or delete it from the file.
  28
 29   Finally, it is worth reading the documentation.
  30
 31 -->
 32
 33 < module  name ="Checker" >
 34      <!--
 35         重复代码的检查，超过8行就认为重复，UTF-8格式 本检查一定要放在"TreeWalker"节点前，否则在
  36         Checkclipse中会无法使用。(在ant下可以)
  37      -->
 38      < module  name ="StrictDuplicateCode" >
 39          < property  name ="min"  value ="8"   />
 40          < property  name ="charset"  value ="UTF-8"   />
 41      </ module >
 42      < module  name ="TreeWalker" >
 43          <!--  javadoc的检查  -->
 44          <!--  检查所有的interface和class  -->
 45          < module  name ="JavadocType"   />
 46          <!--  检查所有方法的javadoc，可以不声明RuntimeException  -->
 47          < module  name ="JavadocMethod" >
 48              < property  name ="allowUndeclaredRTE"  value ="true"   />
 49          </ module >
 50          <!--  检查某个变量的javadoc  -->
 51          < module  name ="JavadocVariable"   />
 52          <!--  命名方面的检查，它们都使用了Sun官方定的规则。  -->
 53          <!--  类名(class 或interface) 的检查  -->
 54          < module  name ="TypeName"   />
 55          <!--  变量的检查  -->
 56          < module  name ="MemberName"   />
 57          <!--  方法名的检查  -->
 58          < module  name ="MethodName"   />
 59          <!--  方法的参数名  -->
 60          < module  name ="ParameterName "   />
 61          <!--  常量名的检查  -->
 62          < module  name ="ConstantName"   />
 63          <!--  长度方面的检查  -->
 64          <!--  文件长度不超过1500行  -->
 65          < module  name ="FileLength" >
 66              < property  name ="max"  value ="1500"   />
 67          </ module >
 68          <!--  每行不超过120个字 -->
 69          < module  name ="LineLength" >
 70              < property  name ="max"  value ="120"   />
 71          </ module >
 72          <!--  方法不超过30行  -->
 73          < module  name ="MethodLength" >
 74              < property  name ="tokens"  value ="METHOD_DEF"   />
 75              < property  name ="max"  value ="30"   />
 76          </ module >
 77          <!--  方法的参数个数不超过3个。  -->
 78          < module  name ="ParameterNumber" >
 79              < property  name ="max"  value ="3"   />
 80          </ module >
 81          <!--  多余的关键字  -->
 82          < module  name ="RedundantModifier"   />
 83          <!--  对区域的检查  -->
 84          <!--  不能出现空白区域  -->
 85          < module  name ="EmptyBlock"   />
 86          <!--  所有区域都要使用大括号。  -->
 87          < module  name ="NeedBraces"   />
 88          <!--  多余的括号  -->
 89          < module  name ="AvoidNestedBlocks" >
 90              < property  name ="allowInSwitchCase"  value ="true"   />
 91          </ module >
 92          <!--  编码方面的检查  -->
 93          <!--  不许出现空语句  -->
 94          < module  name ="EmptyStatement"   />
 95          <!--  每个类都实现了equals()和hashCode()  -->
 96          < module  name ="EqualsHashCode"   />
 97          <!--  不许使用switch  -->
 98          < module  name ="IllegalToken" >
 99              < property  name ="tokens"  value ="LITERAL_SWITCH"   />
100          </ module >
101          <!--  不许内部赋值  -->
102          < module  name ="InnerAssignment"   />
103          <!--  绝对不能容忍魔法数  -->
104          < module  name ="MagicNumber"   />
105          <!--  循环控制变量不能被修改  -->
106          < module  name ="ModifiedControlVariable"   />
107          <!--  多余的throw  -->
108          < module  name ="RedundantThrows"   />
109          <!--  不许使用未被简化的条件表达式  -->
110          < module  name ="SimplifyBooleanExpression"   />
111          <!--  不许使用未被简化的布尔返回值  -->
112          < module  name ="SimplifyBooleanReturn"   />
113          <!--  String的比较不能用!= 和 ==  -->
114          < module  name ="StringLiteralEquality"   />
115          <!--  if最多嵌套3层  -->
116          < module  name ="NestedIfDepth" >
117              < property  name ="max"  value ="3"   />
118          </ module >
119          <!--  try最多被嵌套1层  -->
120          < module  name ="NestedTryDepth"   />
121          <!--  clone方法必须调用了super.clone()  -->
122          < module  name ="SuperClone"   />
123          <!--  finalize 必须调用了super.finalize()  -->
124          < module  name ="SuperFinalize"   />
125          <!--  不能catch java.lang.Exception  -->
126          < module  name ="IllegalCatch" >
127              < property  name ="illegalClassNames"  value ="java.lang.Exception"   />
128          </ module >
129          <!--  JUnitTestCase 的核心方法存在。  -->
130          < module  name ="JUnitTestCase"   />
131          <!--  一个方法中最多有3个return  -->
132          < module  name ="ReturnCount" >
133              < property  name ="max"  value ="3"   />
134          </ module >
135          <!--  不许对方法的参数赋值  -->
136          < module  name ="ParameterAssignment"   />
137          <!--  不许有同样内容的String  -->
138          < module  name ="MultipleStringLiterals"   />
139          <!--  同一行不能有多个声明  -->
140          < module  name ="MultipleVariableDeclarations"   />
141          <!--  各种量度  -->
142          <!--  布尔表达式的复杂度，不超过3  -->
143          < module  name ="BooleanExpressionComplexity"   />
144          <!--  类数据的抽象耦合，不超过7  -->
145          < module  name ="ClassDataAbstractionCoupling"   />
146          <!--  类的分散复杂度，不超过20  -->
147          < module  name ="ClassFanOutComplexity"   />
148          <!--  函数的分支复杂度，不超过10  -->
149          < module  name ="CyclomaticComplexity"   />
150          <!--  NPath复杂度，不超过200  -->
151          < module  name ="NPathComplexity"   />
152          <!--  杂项  -->
153          <!--  禁止使用System.out.println  -->
154          < module  name ="GenericIllegalRegexp" >
155              < property  name ="format"  value ="System\.out\.println"   />
156              < property  name ="ignoreComments"  value ="true"   />
157          </ module >
158          <!--  不许使用与代
主页: http://checkstyle.sourceforge.net/　

Checkstyle配置文件的简要说明
关于配置文件的各个模块的更多细节，请参考CHECKSTYLE_HOME/docs/index.html 
 <? xml version="1.0" encoding="UTF-8" ?>
<! DOCTYPE module PUBLIC "-//Puppy Crawl//DTD Check Configuration 1.2//EN"
"http://www.puppycrawl.com/dtds/configuration_1_2.dtd" >
<!-- 对于所有的模块来书,如果有这个模块则说明检测这一项,没有则不检测这一项 -->
<!-- 所有的模块中,其ROOT必须为Checker -->
< module  name ="Checker" >
<!-- 检验每个包是否存在package.html文件-->
<!-- See http://checkstyle.sf.net/config_javadoc.html#PackageHtml -->
<!--
<module name="PackageHtml"/>
-->
<!-- 检验每个文件末尾是否有一个空行-->
<!-- See http://checkstyle.sf.net/config_misc.html#NewlineAtEndOfFile -->
<!--
<module name="NewlineAtEndOfFile"/>
-->
<!-- Checks that property files contain the same keys. -->
<!-- See http://checkstyle.sf.net/config_misc.html#Translation -->
< module  name ="Translation" />
< module  name ="TreeWalker" >
<!-- Checks for Javadoc comments. -->
<!-- See http://checkstyle.sf.net/config_javadoc.html -->
<!-- Checks Javadoc comments for method definitions.-->
< module  name ="JavadocMethod" >
< property  name ="scope"  value ="public" />
<!-- 是否允许错误的参数声明,true为允许,缺省为不允许 -->
< property  name ="allowMissingParamTags"  value ="true" />
<!-- 是否允许错误的错误声明,true为允许,缺省为不允许 -->
< property  name ="allowMissingThrowsTags"  value ="true" />
<!-- 是否允许错误的返回类型声明,true为允许,缺省为不允许 -->
< property  name ="allowMissingReturnTag"  value ="true" />
</ module >
<!--Checks Javadoc comments for class and interface definitions.-->
< module  name ="JavadocType" />
<!-- Checks that variables have Javadoc comments.-->
< module  name ="JavadocVariable" >
< property  name ="scope"  value ="protected" />
</ module >
<!-- 检查Javadoc的格式 -->
< module  name ="JavadocStyle" >
< property  name ="scope"  value ="public" />
<!-- Comment的第一句的末尾是否要有一个句号,true必须有,default为true -->
< property  name ="checkFirstSentence"  value ="false" />
<!-- 检查错误的HTML脚本,比如不匹配,true检查,default为true -->
< property  name ="checkHtml"  value ="true" />
</ module >
<!-- Checks for Naming Conventions. -->
<!-- See http://checkstyle.sf.net/config_naming.html -->
<!-- 确省必须以Abstract开始或者以Factory结束 -->
<!--
<module name="AbstractClassName"/>
-->
< module  name ="ConstantName" />
< module  name ="LocalFinalVariableName" />
< module  name ="LocalVariableName" />
< module  name ="MemberName" />
< module  name ="MethodName" />
< module  name ="PackageName" />
< module  name ="ParameterName" />
< module  name ="StaticVariableName" />
< module  name ="TypeName" />
<!-- Checks for Headers -->
<!-- See http://checkstyle.sf.net/config_header.html -->
<!-- 检查文件是否以指定文件开始,这里最好是放一些版权信息和工程描述 -->
<!-- headerFile:指定的文件 -->
<!-- ignoreLines:忽略哪些行,以","分隔 -->
<!--
<module name="Header">
<property name="headerFile" value="java.header"/>
<property name="ignoreLines" value="2, 3, 4, 5"/>
</module>
-->
<!-- Following interprets the header file as regular expressions. -->
<!--
<module name="RegexpHeader"/>
-->
<!-- Checks for imports -->
<!-- See http://checkstyle.sf.net/config_import.html -->
<!-- 检查使用*号的导入,默认为全部类 -->
< module  name ="AvoidStarImport" />
<!-- 检查是否有非法的包,确省检查sun.*;对于某些包是不建议直接调用的 -->
< module  name ="IllegalImport" >
< property  name ="illegalPkgs"  value ="sun.*" />
</ module >
<!-- 检查多于的导入,如一个类导入了多次 -->
< module  name ="RedundantImport" />
<!-- 检查没有使用的导入 -->
< module  name ="UnusedImports" />
<!-- 导入排序 -->
<!-- groups:分组,哪些是一组的 -->
<!-- ordered:同一个组内是否排序,true排序,确省为true -->
<!-- separated:各个组之间是否需要用空行分隔,确省为false -->
<!-- caseSensitive:是否是大小写敏感的,确省是 -->
<!--
<module name="ImportOrder">
<property name="groups" value="java,javax"/>
<property name="ordered" value="true"/>
<property name="separated" value="true"/>
<property name="caseSensitive" value="true"/>
</module>
-->
<!-- Checks for Size Violations. -->
<!-- See http://checkstyle.sf.net/config_sizes.html -->
<!-- 检查方法内可执行语句的个数,确省为30行 -->
<!--
<module name="ExecutableStatementCount">
<property name="max" value="30"/>
</module>
-->
<!-- 文件的最大行数,缺省为1500 -->
< module  name ="FileLength" >
< property  name ="max"  value ="2000" />
</ module >
<!-- 每行的最大字符数,缺省为80 -->
< module  name ="LineLength" >
<!-- 忽略指定格式的行,如*号开始的,等 -->
<!--
<property name="ignorePattern" value="^ *\* *[^ ]+$"/>
-->
< property  name ="max"  value ="120" />
</ module >
<!-- 方法的最大行数,缺省为150 -->
< module  name ="MethodLength" >
< property  name ="max"  value ="200" />
<!-- 统计时是否包括空行和以//开始的注释,缺省为统计(true)-->
< property  name ="countEmpty"  value ="false" />
</ module >
<!-- 匿名类的最大行数,缺省为20 -->
< module  name ="AnonInnerLength" >
< property  name ="max"  value ="60" />
</ module >
<!-- 检查方法和构造子参数的最大个数,缺省为7 -->
< module  name ="ParameterNumber" />
<!-- Checks for whitespace -->
<!-- See http://checkstyle.sf.net/config_whitespace.html -->
< module  name ="EmptyForInitializerPad" />
< module  name ="EmptyForIteratorPad" />
< module  name ="MethodParamPad" >
< property  name ="allowLineBreaks"  value ="true" />
</ module >
< module  name ="NoWhitespaceAfter" />
< module  name ="NoWhitespaceBefore" />
< module  name ="OperatorWrap" />
< module  name ="ParenPad" />
< module  name ="TypecastParenPad" />
< module  name ="TabCharacter" />
< module  name ="WhitespaceAfter" />
< module  name ="WhitespaceAround" />
<!-- Modifier Checks -->
<!-- See http://checkstyle.sf.net/config_modifiers.html -->
<!-- 要求JLS suggestions -->
<!--
<module name="ModifierOrder"/>
-->
< module  name ="RedundantModifier" />
<!-- Checks for blocks. You know, those {}'s -->
<!-- See http://checkstyle.sf.net/config_blocks.html -->
<!-- 检查空块 -->
<!--
<module name="EmptyBlock"/>
-->
< module  name ="LeftCurly" />
<!-- 检查只有必须有{},确省为必须,主要在if,else时有这样的情况 -->
< module  name ="NeedBraces" />
<!-- 检查"}",确省在同一行 -->
< module  name ="RightCurly" >
< property  name ="option"  value ="alone" />
</ module >
<!-- 检查多余嵌套的{},请看文档,不易说明 -->
< module  name ="AvoidNestedBlocks" />
<!-- Checks for common coding problems -->
<!-- See http://checkstyle.sf.net/config_coding.html -->
< module  name ="AvoidInlineConditionals" />
< module  name ="CovariantEquals" />
< module  name ="DeclarationOrder" />
< module  name ="DefaultComesLast" />
< module  name ="DoubleCheckedLocking" />
<!--
<module name="EmptyStatement"/>
-->
< module  name ="EqualsHashCode" />
<!-- 变量必须初始化为自己的类型,如果给一个Object类型的变量初始化为null会提示 -->
<!--
<module name="ExplicitInitialization"/>
-->
< module  name ="FallThrough" />
<!--
<module name="FinalLocalVariable"/>
-->
< module  name ="HiddenField" >
< property  name ="ignoreConstructorParameter"  value ="true" />
< property  name ="ignoreSetter"  value ="true" />
</ module >
<!-- Exception, Throwable, RuntimeException是不允许catch的 -->
<!--
<module name="IllegalCatch"/>
-->
< module  name ="IllegalInstantiation" />
<!-- 
<module name="IllegalToken"/>
-->
< module  name ="IllegalTokenText" />
< module  name ="IllegalType" />
< module  name ="InnerAssignment" />
<!--检查直接数
<module name="MagicNumber"/>
检查是否有构造子
<module name="MissingCtor"/>
-->
< module  name ="MissingSwitchDefault" />
< module  name ="MultipleVariableDeclarations" />
<!--
<module name="JUnitTestCase"/>
<module name="NestedIfDepth"">
<property name="max" value="5"/>
</module>
<module name="NestedTryDepth"">
<property name="max" value="5"/>
</module>
<module name="PackageDeclaration"/>
<module name="ReturnCount"/>
-->
<!-- 不能为参数付值 -->
<!--
<module name="ParameterAssignment"/>
-->
< module  name ="RedundantThrows" />
<!-- 不能理解的,好像是bug
<module name="RequireThis"/>
-->
< module  name ="SimplifyBooleanExpression" />
< module  name ="SimplifyBooleanReturn" />
< module  name ="StringLiteralEquality" />
< module  name ="SuperClone" />
< module  name ="SuperFinalize" />
< module  name ="UnnecessaryParentheses" />
<!-- Checks for class design -->
<!-- See http://checkstyle.sf.net/config_design.html -->
<!-- 要求一个方法必须声明为Extension的,否则必声明为abstract, final or empty -->
<!--
<module name="DesignForExtension"/>
-->
<!-- 检查private构造子是否声明为final,这里有个问题,在Java中构造子是不能声明为final的 -->
<!--
<module name="FinalClass"/>
-->
<!-- 要求一定要有一个构造子 -->
<!--
<module name="HideUtilityClassConstructor"/>
-->
< module  name ="InterfaceIsType" />
<!-- 检查变量的可见性,确省只允许static final 为public,否则只能为private -->
< module  name ="VisibilityModifier" >
< property  name ="packageAllowed"  value ="true" />
< property  name ="protectedAllowed"  value ="true" />
</ module >
<!--
<module name="MutableException"/>
-->
<!-- 限制抛出声明的指定数量,确省为1 -->
<!--
<module name="ThrowsCount"/>
-->
<!-- Miscellaneous other checks. -->
<!-- See http://checkstyle.sf.net/config_misc.html -->
<!-- 数组的声明是否允许Java的类型,确省为允许,Java类型为String[] xx,C++的类型为String xx[]; -->
< module  name ="ArrayTypeStyle" />
<!--
<module name="FinalParameters"/>
-->
<!-- 一般性的代码问题,不好的习惯等,可以多 -->
<!-- 文件中使用了System.out.print等-->
< module  name ="GenericIllegalRegexp" >
< property  name ="format"  value ="System\.out\.print" />
< property  name ="message"  value ="bad practice of use System.out.print" />
</ module >
< module  name ="GenericIllegalRegexp" >
< property  name ="format"  value ="System\.exit" />
< property  name ="message"  value ="bad practice of use System.exit" />
</ module >
< module  name ="GenericIllegalRegexp" >
< property  name ="format"  value ="printStackTrace" />
< property  name ="message"  value ="bad practice of use printStackTrace" />
</ module >
<!-- 关于Task,你可以声明自己的Task标识 -->
< module  name ="TodoComment" >
< property  name ="format"  value ="TODO" />
</ module >
<!-- 强迫//注释必须如何,入下要求只能有一行,具体看文档 -->
<!--
<module name="TrailingComment">
<property name="format" value="^\\s*$"/>
</module>
-->
<!-- main方法经常会在debug时使用,但发行版本的时候可能并不需要这个方法,提示 -->
<!--
<module name="UncommentedMain"/>
-->
<!-- 当定义一个常量时,希望使用大写的L来代替小写的l,原因是小写的l和数字1很象 -->
< module  name ="UpperEll" />
<!-- 检查正确的缩进,这个更象是个人习惯 -->
<!--
<module name="Indentation">
<property name="braceAdjustment" value="0"/>
</module>
-->
<!-- Checks For Metrics -->
<!-- See http://checkstyle.sf.net/config_metrics.html -->
<!-- 检查嵌套复杂度 -->
< module  name ="CyclomaticComplexity" >
< property  name ="max"  value ="12" />
</ module >
</ module >
</ module >
Checkstyle常见的输出结果
1．Type is missing a javadoc commentClass 
缺少类型说明
2．“{” should be on the previous line
“{” 应该位于前一行
3．Methods is missing a javadoc comment
方法前面缺少javadoc注释
4．Expected @throws tag for “Exception”
在注释中希望有@throws的说明
5．“.” Is preceeded with whitespace “.”
前面不能有空格
6．“.” Is followed by whitespace“.”
后面不能有空格
7．“=” is not preceeded with whitespace
“=” 前面缺少空格
8．“=” is not followed with whitespace 
“=” 后面缺少空格
9．“}” should be on the same line 
“}” 应该与下条语句位于同一行
10．Unused @param tag for “unused”
没有参数“unused”，不需注释
11．Variable “CA” missing javadoc
变量“CA”缺少javadoc注释
12．Line longer than 80characters 
行长度超过80
13．Line contains a tab character
行含有”tab” 字符
14．Redundant “Public” modifier
冗余的“public” modifier
15．Final modifier out of order with the JSL
suggestionFinal modifier的顺序错误
16．Avoid using the “.*” form of import
Import格式避免使用“.*”
17．Redundant import from the same package
从同一个包中Import内容
18．Unused import-java.util.list
Import进来的java.util.list没有被使用
19．Duplicate import to line 13
重复Import同一个内容
20．Import from illegal package
从非法包中 Import内容
21．“while” construct must use “{}”
“while” 语句缺少“{}”
22．Variable “sTest1” must be private and have accessor method
变量“sTest1”应该是private的，并且有调用它的方法
23．Variable “ABC” must match pattern “^[a-z][a-zA-Z0-9]*$” 
变量“ABC”不符合命名规则“^[a-z][a-zA-Z0-9]*$”
24．“(” is followed by whitespace 
“(” 后面不能有空格
25．“)” is proceeded by whitespace
“)” 前面不能有空格
 
码同行的注释  -->
159          < module  name ="TrailingComment"   />
160      </ module >
161      <!--  检查翻译文件  -->
162      < module  name ="Translation"   />
163 </ module >
164



checkStyle结果分析

参考：http://commons.apache.org/jelly/libs/http/checkstyle-report.html

1.Missing a Javadoc comment:缺少JavaDoc注释
2.First sentence should end with a period:你的注释的第一行文字结束应该加上一个"."
3.Expected @throws tag for 'Exception':在注释中希望有@throws的说明,在方法前得注释中添加这样一行：* @throws Exception if has error(异常说明)
4.Parameter docType should be final:参数docType应该为final类型  解决方法：在参数docType前面加个final
5.Variable “ABC” must match pattern “^[a-z][a-zA-Z0-9]*$”变量“ABC”不符合命名规则“^[a-z][a-zA-Z0-9]*$”解决方法：把这个命名改成符合规则的命名 “aBC”
6.Utility classes should not have a public or default constructor. 接口中的内部类中不应该有公共的或者默认的构造方法
解决方法：在内部类中，定义一个私有的构造方法，然后内部类声明为final类型。如果前面有static，那么final还必须放在static之后
7.'{' is not preceded with whitespace.大括号后面必须空一格

8.'public' modifier out of order with the JLS suggestions.   public顺序错误

9.Method 'deleteChild' is not designed for extension - needs to be abstract, final or empty.  不是拓展或继承的方法，必须指定abstract,final或空

 

 

1Type is missing a javadoc commentClass  缺少类型说明

2“{” should be on the previous line“{” 应该位于前一行。解决方法：把“{”放到上一行去

3Methos is missing a javadoc comment 方法前面缺少javadoc注释。解决方法：添加javadoc注释 类似这样：

/**

     * set default mock parameter.（方法说明）

     * @param additionalParameters  parameter additional(参数名称)

     * @return data manager(返回值说明)

     * @throws Exception if has error(异常说明)

     */

4 Expected @throws tag for “Exception”在注释中希望有@throws的说明

解决方法：在方法前得注释中添加这样一行：* @throws Exception if has error(异常说明)

5“.” Is preceeded with whitespace “.” 前面不能有空格。解决方法：把“（”前面的空格去掉

6“.” Is followed by whitespace“.” 后面不能有空格。解决方法：把“）”后面的空格去掉

7“=” is not preceeded with whitespace“=” 前面缺少空格。解决方法：在“=”前面加个空格

8“=” is not followed with whitespace“=” 后面缺少空格。解决方法：在“=”后面加个空格

9“}” should be on the same line“}” 应该与下条语句位于同一行。解决方法：把“}”放到下一行的前面

10Unused @param tag for “unused”没有参数“unused”，不需注释

解决方法：“* @param unused  parameter additional(参数名称)” 把这行unused参数的注释去掉“

11Variable “CA” missing javadoc变量“CA”缺少javadoc注释

解决方法：在“CA“变量前添加javadoc注释：/** CA. */（注意：一定记得加上“.”）

12Line longer than 80characters行长度超过80  。解决方法：把它分成多行写。必要时候，可以ctrl+shift+f

13Line contains a tab character行含有”tab” 字符。快速解决方法：可以使用editplus中的format功能，把tab字符转化为空格，然后保存Editplus英文版安装文件在我机子上有。需要的可以来拷贝。注册Editplus，点击安装文件中注册的文件


14Redundant “Public” modifier冗余的“public” modifier   。解决方法：冗余的“public”

15Final modifier out of order with the JSL suggestion Final modifier的顺序错误

16Avoid using the “.*” form of importImport格式避免使用“.*”

17Redundant import from the same package从同一个包中Import内容

18Unused import-java.util.listImport进来的java.util.list没有被使用。解决方法：去掉导入的多余的类

19Duplicate import to line 13重复Import同一个内容    解决方法：去掉导入的多余的类

20Import from illegal package从非法包中 Import内容

21“while” construct must use “{}”  “while” 语句缺少“{}”

22Variable “sTest1” must be private and have accessor method变量“sTest1”应该是private的，并且有调用它的方法

23Variable “ABC” must match pattern “^[a-z][a-zA-Z0-9]*$”变量“ABC”不符合命名规则“^[a-z][a-zA-Z0-9]*$”解决方法：把这个命名改成符合规则的命名 “aBC”

24“(” is followed by whitespace“(” 后面不能有空格 25“)”is proceeded by whitespace“)” 前面不能有空格

解决方法：把前面或者后面的空格去掉

25、First sentence should end with a period.解决方法：你的注释的第一行文字结束应该加上一个"."。


26、Redundant throws: 'NameNotFoundException' is subclass of 'NamingException'. 'NameNotFoundException '是'NamingException'的子类重复抛出异常。

解决方法：如果抛出两个异常，一个异常类是另一个的子类，那么只需要写父类

去掉NameNotFoundException异常，对应的javadoc注释异常注释说明也需要去掉


27、Parameter docType should be final.  参数docType应该为final类型  解决方法：在参数docType前面加个final


28、Line has trailing spaces.  多余的空行  解决方法：去掉这行空行


29.Must have at least one statement.  至少一个声明

解决方法：} catch (NumberFormatException nfe) {

 LOG.error("Auto Renews the agreement failed", nfe);//异常捕捉里面不能为空，在异常里面加一句话。如打印等等

 

30、'>' is not followed by whitespace.并且又有 '(' is preceded with whitespace.

定义集合和枚举的时候的时候，最后一个“>”后面要有空格，“（”前面不容许有空格。解决方法：去掉泛型


31、Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag 'SystemException'.原因：不合理的throws。

解决方法：要确保某些类型，如某些类、接口不被throws。把声明的异常去掉。在实现类中抛出异常


网上参考解决方法：1、这是CheckStyle报的错。通常需要Refreh, clean/build这个Project. 如果不行，可以尝试clean all projects, restart Eclipse.

2、因为编译好的类没有在checkstyle的classpath中.所以, 只要将编译好的class配置到在<checkstyle/>的classpath中就没有这个问题了.另外, 还发现checkstyle的line length好像也有点问题, 明明没有超过120个字符, 却还是报错.无奈, 我把Eclipse中java > code style > formatter中的Maximum line with改成了100, 然后format一下, 基本就没有问题了


32、File does not end with a newline.解决方法：删掉报错的类，新建一个同名的类，把代码全部复制过去


33、Utility classes should not have a public or default constructor. 接口中的内部类中不应该有公共的或者默认的构造方法

解决方法：在内部类中，定义一个私有的构造方法，然后内部类声明为final类型。如果前面有static，那么final还必须放在static之后


34、Variable 'functionCode' must be private and have accessor methods.变量要改成private然后提供访问的方法

解决方法：给这些变量的修饰符改成private，然后提供set，get方法，并加上对应的方法javadoc注释、参数注释。并在返回值和参数类型前添加final。并把调用了这个变量的地方改成通过方法访问


35.  'X' hides a field.

public class Foo
{
    private int bar;

    public Foo(int bar)
    {
        this.bar = bar;
    }

    public final int getBar()
    {
        return bar;
    }
}

全局private int bar;和局部public Foo(int bar)的bar变量名字重复。
解决方法：把方法里面的参数名称改变下就可以了public Foo(int newBar)
    {
        this.bar = newBar;
    }。

 

36、Got an exception - Unexpected character 0xfffd in identifier

这是因为CheckStyle不能识别制定的编码格式。

网上参考解决方法：

1、Eclipse中可以配置，在Other-->checker中可以指定

            2、可以修改checkstyle配置文件：

<module name="Checker">

            <property name="severity" value="warning"/>

<property name="charset" value="UTF-8"/>

                      <module name="TreeWalker">

            如果是UTF-8的话，就添加加粗的那条语句，就可以了。

37、 Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag *whatever*.
    网上参考解决方法：选中CheckSytle的JavaDoc --> Method JavaDoc --> logLoadErrors。如果是CheckStyle自己加载时出错的，打个Log就可以了，不要整出Errors吓人。
   还有一处也可能包出同样的错误。Coding Problems --> Redundant Throws --> logLoadErrors选中即可


38、Expected @param tag for 'dataManager'.    缺少dataManager参数的注释   解决方法：在注释中添加@param  dataManager  DataManager

网上一些其他错误的解答：
1. Parameter X should be final.
public class Foo
{
    private int bar;

    public Foo(int bar)
    {
        this.bar = bar;
    }

    public final int getBar()
    {
        return bar;
    }
}

解释：public Foo(int bar)的局部变量，被认为是不可改变的，检查需要加上final关键字定义public Foo(final int bar)此错误，可以忽略不检查。

2. Redundant 'X' modifier.

public interface CacheHRTreeService extends Manager {

 /**
  * Organization Tree
  * @param orgDto
  * @return
  * @throws Exception
  */
 public void setOrganization(OrganizationDTO orgDto) throws Exception;

 /**
  * Organization Tree
  * @return
  * @throws Exception
  */
 public OrganizationDTO getOrganization() throws Exception;
......
}

解释：多余的字段。public OrganizationDTO getOrganization() throws Exception;此时public为多余的字段，因为interface定义的时候，就是public的。

需要检查。

3. - Class X should be declared as final.

解释：对于单例设计模式，要求返回唯一的类对象。但是HRFactory和ContextFactory为优化的两个类，不需求检查。
其他的单例类，依然需要进行检查。

4. - Method 'addChildrenId' is not designed for extension - needs to be
  abstract, final or empty.

解释：通过父类继承的，此类有点特殊可以忽略此类。

5. Variable 'id' must be private and have accessor methods.解释：BaseHRDTO类，为父类，属性给子类继承，比较特殊。但是其他的类，声名需要加上范围'private'关键字。需要检查。

6. -Array brackets at illegal position.解释：代码写法，习惯不一样。需要检查，仅仅提示

转载 ：http://www.blogjava.net/japper/archive/2012/05/24/379054.html



eclipse的插件checkStyle结果分析

安装checkStyle插件以及配置

安装：直接update，添加更新源地址：http://eclipse-cs.sf.net/update/，也可以从http://sourceforge.net/projects/eclipse-cs/files/ 下载最新的插件包本地进行安装。

配置：默认安装有2个检查的配置文件，如下图，Type为Build-In的是默认的，可以自己按照内置的Copy一个出来后进行修改，或者Import已经存在的检查xml配置文件。

image 

配合着使用的还有一个Codestyle，如下图，设计到有Clean up、Template、Formatter等几个选项，默认的Eclopse 提供的Clean up好像什么事情都没做，所以最好是自己新建一个或者是导入一个。

image .

常见提示解释

1Type is missing a javadoc commentClass 缺少类型说明

2“{” should be on the previous line“{” 应该位于前一行。解决方法：把“{”放到上一行去

3Methos is missing a javadoc comment 方法前面缺少javadoc注释。解决方法：添加javadoc注释 类似这样：

/**

* set default mock parameter.（方法说明）

* @param additionalParameters parameter additional(参数名称)

* @return data manager(返回值说明)

* @throws Exception if has error(异常说明)

*/

4 Expected @throws tag for “Exception”在注释中希望有@throws的说明

解决方法：在方法前得注释中添加这样一行：* @throws Exception if has error(异常说明)

5“.” Is preceeded with whitespace “.” 前面不能有空格。解决方法：把“（”前面的空格去掉

6“.” Is followed by whitespace“.” 后面不能有空格。解决方法：把“）”后面的空格去掉

7“=” is not preceeded with whitespace“=” 前面缺少空格。解决方法：在“=”前面加个空格

8“=” is not followed with whitespace“=” 后面缺少空格。解决方法：在“=”后面加个空格

9“}” should be on the same line“}” 应该与下条语句位于同一行。解决方法：把“}”放到下一行的前面

10Unused @param tag for “unused”没有参数“unused”，不需注释

解决方法：“* @param unused parameter additional(参数名称)” 把这行unused参数的注释去掉“

11 Variable “CA” missing javadoc变量“CA”缺少javadoc注释

解决方法：在“CA“变量前添加javadoc注释：/** CA. */（注意：一定记得加上“.”）

12 Line longer than 80characters行长度超过80  。解决方法：把它分成多行写。必要时候，可以ctrl+shift+f

13 Line contains a tab character行含有”tab” 字符。快速解决方法：可以使用editplus中的format功能，把tab字符转化为空格，然后保存Editplus英文版安装文件在我机子上有。需要的可以来拷贝。注册Editplus，点击安装文件中注册的文件

14 Redundant “Public” modifier冗余的“public” modifier   。解决方法：冗余的“public”

15 Final modifier out of order with the JSL suggestion Final modifier的顺序错误

16 Avoid using the “.*” form of importImport格式避免使用“.*”

17 Redundant import from the same package从同一个包中Import内容

18 Unused import-java.util.listImport进来的java.util.list没有被使用。解决方法：去掉导入的多余的类

19 Duplicate import to line 13重复Import同一个内容    解决方法：去掉导入的多余的类

20 Import from illegal package从非法包中 Import内容

21 “while” construct must use “{}”  “while” 语句缺少“{}”

22 Variable “sTest1” must be private and have accessor method变量“sTest1”应该是private的，并且有调用它的方法

23 Variable “ABC” must match pattern “^[a-z][a-zA-Z0-9]*$”变量“ABC”不符合命名规则“^[a-z][a-zA-Z0-9]*$”解决方法：把这个命名改成符合规则的命名 “aBC”

24 “(” is followed by whitespace“(” 后面不能有空格 25“)”is proceeded by whitespace“)” 前面不能有空格

解决方法：把前面或者后面的空格去掉

25 First sentence should end with a period.解决方法：你的注释的第一行文字结束应该加上一个"."。

26 Redundant throws: 'NameNotFoundException' is subclass of 'NamingException'. 'NameNotFoundException '是'NamingException'的子类重复抛出异常。

解决方法：如果抛出两个异常，一个异常类是另一个的子类，那么只需要写父类

去掉NameNotFoundException异常，对应的javadoc注释异常注释说明也需要去掉

27 Parameter docType should be final. 参数docType应该为final类型  解决方法：在参数docType前面加个final

28 Line has trailing spaces. 多余的空行  解决方法：去掉这行空行

29 Must have at least one statement.  至少一个声明

解决方法：} catch (NumberFormatException nfe) {

LOG.error("Auto Renews the agreement failed", nfe);//异常捕捉里面不能为空，在异常里面加一句话。如打印等等

30 '>' is not followed by whitespace.并且又有 '(' is preceded with whitespace.

定义集合和枚举的时候的时候，最后一个“>”后面要有空格，“（”前面不容许有空格。解决方法：去掉泛型

31 Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag 'SystemException'.原因：不合理的throws。

解决方法：要确保某些类型，如某些类、接口不被throws。把声明的异常去掉。在实现类中抛出异常

网上参考解决方法：1、这是CheckStyle报的错。通常需要Refreh, clean/build这个Project. 如果不行，可以尝试clean all projects, restart Eclipse.

2、因为编译好的类没有在checkstyle的classpath中.所以, 只要将编译好的class配置到在<checkstyle/>的classpath中就没有这个问题了.另外, 还发现checkstyle的line length好像也有点问题, 明明没有超过120个字符, 却还是报错.无奈, 我把Eclipse中java > code style > formatter中的Maximum line with改成了100, 然后format一下, 基本就没有问题了

32 File does not end with a newline.解决方法：删掉报错的类，新建一个同名的类，把代码全部复制过去

33 Utility classes should not have a public or default constructor. 接口中的内部类中不应该有公共的或者默认的构造方法

解决方法：在内部类中，定义一个私有的构造方法，然后内部类声明为final类型。如果前面有static，那么final还必须放在static之后

34 Variable 'functionCode' must be private and have accessor methods.变量要改成private然后提供访问的方法

解决方法：给这些变量的修饰符改成private，然后提供set，get方法，并加上对应的方法javadoc注释、参数注释。并在返回值和参数类型前添加final。并把调用了这个变量的地方改成通过方法访问

35   'X' hides a field.

public class Foo
{
    private int bar;

    public Foo(int bar)
    {
        this.bar = bar;
    }

    public final int getBar()
    {
        return bar;
    }
}

全局private int bar;和局部public Foo(int bar)的bar变量名字重复。
解决方法：把方法里面的参数名称改变下就可以了public Foo(int newBar)
    {
        this.bar = newBar;
    }。

36 Got an exception - Unexpected character 0xfffd in identifier

这是因为CheckStyle不能识别制定的编码格式。

网上参考解决方法：

1、Eclipse中可以配置，在Other-->checker中可以指定

2、可以修改checkstyle配置文件：

<module name="Checker">

<property name="severity" value="warning"/>

<property name="charset" value="UTF-8"/>

<module name="TreeWalker">

如果是UTF-8的话，就添加加粗斜体的那条语句，就可以了。

37  Got an exception - java.lang.RuntimeException: Unable to get class information for @throws tag *whatever*.
网上参考解决方法：选中CheckSytle的JavaDoc --> Method JavaDoc --> logLoadErrors。如果是CheckStyle自己加载时出错的，打个Log就可以了，不要整出Errors吓人。
还有一处也可能包出同样的错误。Coding Problems --> Redundant Throws --> logLoadErrors选中即可

38 Expected @param tag for 'dataManager'. 缺少dataManager参数的注释   解决方法：在注释中添加@param dataManager DataManager

网上一些其他错误的解答：
1. Parameter X should be final.
public class Foo
{
    private int bar;

    public Foo(int bar)
    {
        this.bar = bar;
    }

    public final int getBar()
    {
        return bar;
    }
}

解释：public Foo(int bar)的局部变量，被认为是不可改变的，检查需要加上final关键字定义public Foo(final int bar)此错误，可以忽略不检查。

2. Redundant 'X' modifier.

public interface CacheHRTreeService extends Manager {

/**
  * Organization Tree
  * @param orgDto
  * @return
  * @throws Exception
  */
public void setOrganization(OrganizationDTO orgDto) throws Exception;

/**
  * Organization Tree
  * @return
  * @throws Exception
  */
public OrganizationDTO getOrganization() throws Exception;
......
}

解释：多余的字段。public OrganizationDTO getOrganization() throws Exception;此时public为多余的字段，因为interface定义的时候，就是public的。

需要检查。

3. - Class X should be declared as final.

解释：对于单例设计模式，要求返回唯一的类对象。但是HRFactory和ContextFactory为优化的两个类，不需求检查。
其他的单例类，依然需要进行检查。

4. - Method 'addChildrenId' is not designed for extension - needs to be
  abstract, final or empty.

解释：通过父类继承的，此类有点特殊可以忽略此类。

5. Variable 'id' must be private and have accessor methods.解释：BaseHRDTO类，为父类，属性给子类继承，比较特殊。但是其他的类，声名需要加上范围'private'关键字。需要检查。

6. -Array brackets at illegal position.解释：代码写法，习惯不一样。需要检查，仅仅提示



转载 ：http://www.cnblogs.com/bluesky4485/archive/2011/11/30/2269198.html

qeqeqe236
关注
  • 0
    点赞
  • 踩
  • 4
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
eclipse中配置checkStyle和使用方法
12-22
在Eclipse当中安装CheckStyle插件非常方便，和安装findBugs除了URL有区别之外，其他的几乎完全一样。我们可以参照以下几个步骤进行（注意一下，eclipse版本不一样，可能安装插件的位置有所调整，但是安装方法都是一样的，具体根据自己版本进行安装。）
eclipse离线安装checkStyle插件--附带插件安装包
11-19
文件 附带插件安装包. 插件安装包下载时间2018-11-12日 离线安装.免去在线安装的网络烦恼.. 离线安装的方法通用于其他插件安装
编码规范系列（二）：Eclipse Checkstyle配置
chenzhou123520的专栏
08-09 318
上一篇介绍了《编码规范系列（一）：Eclipse Code Templates设置》，这篇主要介绍Eclipse中Checkstyle的配置。关于Checkstyle，引用百度百科的介绍如下：CheckStyle是SourceForge下的一个项目，提供了一个帮助JAVA开发人员遵守某些编码规范的工具。它能够自动化代码规范检查过程，从而使得开发人员从这项重要，但是枯燥的任务中解脱出来。CheckS...
详解CheckStyle的检查规则（共138条规则）
weixin_34005042的博客
02-26 1299
2019独角兽企业重金招聘Python工程师标准>>> ...
IDEA中配置alibaba代码规范校验工具checkstyle详细教程
最新发布
不积跬步，无以至千里；不积小流，无以成江海。
06-17 965
CheckStyle 是一个用于检查 Java 代码风格的工具。它可以帮助开发人员在编写代码时遵循一致的编码规范，从而提高代码的可读性和可维护性。CheckStyle 提供了一系列预定义的规则，这些规则可以轻松地配置和扩展以满足特定项目的需求。
静态分析工具及使用总结（二）CheckStyle
novelly的专栏
11-05 1746
这里主要介绍三种开源的工具，PMD、CheckStyle和FindBugs，着重是在Ant里的调用，据说商业软件JTest也是著名的代码分析工具，哈哈，要花钱的没有用过。   Checkstyle （http://checkstyle.sourceforge.net/）版本4.2 简介: Checkstyle 是一个开发工具，可以帮助程序员遵循代码规范的编写代码， 它自动的
checkstyle配置文件说明
10-09
Checkstyle 是一个强大的静态代码分析工具，用于检测 Java 代码中的风格问题和潜在错误。配置文件是 Checkstyle 工作的核心，它定义了一系列规则来确保代码遵循特定的编码规范。以下是对 Checkstyle 配置文件中各个...
Checkstyle使用说明文档
04-21
中文版Checkstyle使用说明文档
Eclipse_CheckStyle配置
12-17
Eclipse的CheckStyle配置，实践经验建议配置。
CheckStyle结果分析
12-17
CheckStyle结果分析 .doc
Jenkins中FindBugs、PMD、CheckStyle和Violations静态分析工具安装配置
04-04
Jenkins 中 FindBugs、PMD、CheckStyle 和 Violations 静态分析工具安装配置 Jenkins 是一个流行的自动化构建和 Continuous Integration（CI）工具，通过安装和配置静态分析工具，可以对 Java 代码进行检测和改进。...
checkstyle.xml
12-19
checkstyle模板文件-基于springside微调
eclipse集成checkStyle
03-06
由于在eclipse里安装checkstyle 输入链接经常报错，所以整了一个离线包，内含checkstyle的检查方式，也可以自己编辑
eclipse插件checkstyle
01-17
eclipse插件checkstyle 检查代码的好帮手
checkstyle配置文件
05-22
checkstyle 配置文件
checkstyle使用说明
03-17
【Checkstyle使用说明】 Checkstyle是一款强大的Java代码检查工具，它可以帮助开发者遵循特定的编码规范和最佳实践。这款工具广泛应用于各种项目，以确保代码的一致性和可维护性。通过执行一系列预定义的规则，...
Eclipse插件CheckStyle安装以及使用
三言两语
11-02 146
Eclipse插件CheckStyle安装以及使用 ...
checkStyle 文档
xuehanxin的专栏
08-16 275
  checkStyle 文档 &lt;!--[if !supportLists]--&gt;1.    &lt;!--[endif]--&gt;checkStyle简介 Checksytle 是一款代码格式检查工具。它可以根据设置好的编码规则来检查代码。比如符合规范的变量命名，良好的程序风格等等。如果你的项目经理开会时说，“我希望我们写出来的代码就象一个人写的！” 时，用Checks...
CheckStyle 自定义编码规范
热门推荐
NOPR_W的博客
09-09 1万+
CheckStyle能够帮助程序员检查代码是否符合制定的规范。通过将CheckStyle的检查引入到项目构建中，可以强制让项目中的所有的开发者遵循制定规范，而不是仅仅停留在纸面上。如果发现代码违反了标准，比如类名未以大写开头、单个方法超过了指定行数、甚至单个方法抛出了3个以上的异常等。这些检查由于是基于源码的，所以不需要编译，执行速度快。 官网地址： https://checkstyle.org/...
checkstyle配置
08-03
Checkstyle的配置是通过指定modules来应用到Java文件的。modules是一个树状结构，其中以一个名为Checker的module作为根节点，通常还包括一个名为TreeWalker的子module。我们可以参考Checkstyle中的sun_checks.xml...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值