checkstyle用法

一、简介

      CheckStyle是SourceForge下的一个项目，提供了一个帮助JAVA开发人员遵守某些编码规范的工具。它能够自动化代码规范检查过程，从而使得开发人员从这项重要，但是枯燥的任务中解脱出来。

二、安装

      安装有两种方式，和SVN类似，即离线安装和在线安装。接下来分别介绍这两种安装方式

2.1离线安装

• 去官网下载CheckStyle插件，官网地址：https://sourceforge.net/projects/eclipse-cs/files/Eclipse%20Checkstyle%20Plug-in/
• 在某个目录（D:\Java）创建checkstyle\eclipse子目录，将之前下载的插件下的features和plugins两个文件下拷贝到该目录下（D:\Java\checkstyle\eclipse）
• 接着在eclipse的links目录下新建checkstyle.xml文件，在该文件中添加一行写上需要链接的插件地址，例如：path=D:/Java/checkstyle
  注：此种方式便于管理外部Eclipse插件

2.2在线安装

• 打开eclipse，点击“help->Install New Software…”
• 单击“Add”，输入Name：CheckStyle和Location：http://eclipse-cs.sourceforge.net/update/
• 单击“OK”，出来两个选项，勾选上然后单击“Next”
• 出现安装详情，单击“Next”，遇到需要同意协议的，选择同意，直到最后
• 安装过程中，会有安全提示窗口，点击“OK”
• 重启后就可以使用了

三、使用

      选择某个项目，点击右键选择“Checkstyle”，会出现如下菜单：

Ⅰ Configure project(s) from blueprint：指定工程加入Checkstyle检查
Ⅱ Activate Checkstyle：激活Checkstyle
Ⅲ Deactivate Checkstyle：取消激活Checkstyle
Ⅴ Check code with Checkstyle：使用Checkstyle检查代码
Ⅳ Clear Checkstyle violations：去掉Checkstyle的检查提示

      选择“Check code with Checkstyle”对所选中的项目进行检查，检查后对有问题的类会使用警告或错误标识。参考提示信息如下：

Checkstyle默认换号是两个空格，我们在项目中一般都是一个tab或四个空格（这里注意，一个tab在eclipse中默认是8个空格），此时就需要我们自定义检查内容

      接下分别介绍Checkstyle中错误信息的含义和自定义检查内容

四、常见提示速查

      Checkstyle常见错误和警告提示见下表所示：

错误提示	错误说明
missing a javadoc comment	缺少注释
Line longer than X characters	行长度超过X个字符(包括空格)
Return count is X(max allowed 3)	一个方法内的返回数量是X(最大值只能为3)
Nested if-else depth is X(max allowed is 3)	最大的if-else嵌套层数为X(最大只能为3)
Array brackets at illegal position	数组的方括号“[]”的位置不正确（检查数组类型的定义是String[] args，而不是String args[]）
Line matchs the illegal pattern ‘System.out.println’	本行包含System.out.println语句
ctor def modifier at indentation level 8 not at corrent indentation 4	缩进不正确，一般是因为没有在Eclipse中使用4个空格代替tab键引起
‘static’ modifier out of order with the JLS suggestions	static修饰符没有按照JLS的建议来排序(eg.写成public final static…应该改成public static final)
Name ‘X’ must match pattern ‘^[A-Z][A-Z0-9][_A-Z0-9+]$’(正则表达式)	名称不符合正则表达式’^[A-Z][A-Z0-9][_A-Z0-9+]$’(即为大写字母，数字、下划线等)。一般在静态变量没有大写时提示，包名不是全部消息时提示，类名不是大写开头时提示，方法名不是小写开头时提示
Variable access definition in wrong order	变量定义顺序不正确(例如在类成员变量定义时，将private类型的变量定义在public类型的变量之前)
Static variable definition in wrong order	静态变量定义顺序不正确(例如在构造函数之后定义静态变量)
Instance variable definition in wrong order	成员变量定义顺序不正确(例如在构造函数之后定义成员变量)
X is a magic number	X是一个魔术数字(非0、1、2的数字)
if construct must use ‘{}’	if结构必须使用’{}’
Got an exception - Unexpected character 0xfffd in identifier	因为没有设置checkstyle配置文件的charset为UTF-8，而类文件使用UTF-8编码，并且含有中文
“{” should be on the previous line	“{” 应该位于前一行
Methods is missing a javadoc comment	方法前面缺少javadoc注释
Expected @throws tag for “Exception”	在注释中希望有@throws的说明
“.” Is preceeded with whitespace	“.” 前面不能有空格
“.” Is followed by whitespace	“.” 后面不能有空格
“=” is not preceeded with whitespace“=”	“=” 前面缺少空格
“=” is not followed with whitespace	“=” 后面缺少空格
“}” should be on the same line	“}” 应该与下条语句位于同一行
Unused @param tag for “unused”	没有参数“unused”，不需注释
Variable “X” missing javadoc	变量“X”缺少javadoc注释
Line contains a tab character	行含有”tab” 字符
Redundant “Public” modifier	冗余的“public” modifier
final modifier out of order with the JSL suggestion	final修饰符的顺序错误
Avoid using the “.*” form of import	Import格式避免使用“.*”
Redundant import from the same package	从同一个包中Import内容
Unused import-X Import	import的X类没有被使用
Duplicate import to line X	重复Import同一个内容
Import from illegal package	从非法包中 Import内容
“while” construct must use “{}”	“while” 语句缺少“{}”
Variable “X” must be private and have accessor method	变量“X”应该是private的，并且有调用它的方法
Variable “X” must match pattern “^[a-z][a-zA-Z0-9]*$”	变量“X”不符合命名规则“^[a-z][a-zA-Z0-9]*$”
“(” is followed by whitespace	“(” 后面不能有空格
“)” is proceeded by whitespace	“)” 前面不能有空格

五、自定义检查内容

      Checkstyle提供的默认检查不一定就适用于我们的开发习惯，因此我们可以根据自己的开发习惯指定Checkstyle检查的格式。下面给出制定Checkstyle检查示例

<module name="Checker">
    <property name="severity" value="warning" />
    <module name="StrictDuplicateCode">
        <property name="charset" value="utf-8" />
    module>

    <module name="TreeWalker">
        
        
        <module name="JavadocType" />

        
        
        <module name="LocalFinalVariableName" />
        
        <module name="LocalVariableName" />
        
        <module name="PackageName">
            <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$" />
        module>
        
        <module name="StaticVariableName" />
        
        <module name="TypeName" />
        
        <module name="MemberName" />
        
        <module name="MethodName" />
        
        <module name="ParameterName " />
        
        <module name="ConstantName" />
        
        <module name="UnusedImports" />

        
        
        <module name="FileLength">
            <property name="max" value="1500" />
        module>
        
        <module name="LineLength">
            <property name="max" value="120" />
        module>
        
        <module name="MethodLength">
            <property name="tokens" value="METHOD_DEF" />
            <property name="max" value="150" />
        module>
        
        <module name="ParameterNumber">
            <property name="max" value="5" />
            <property name="tokens" value="METHOD_DEF" />
        module>

        
        
        <module name="MethodParamPad" />
        
        <module name="TypecastParenPad" />

        
        
        <module name="ModifierOrder" />
        
        <module name="RedundantModifier" />

        
        
        <module name="EmptyBlock" />
        
        <module name="NeedBraces" />
        
        <module name="AvoidNestedBlocks">
            <property name="allowInSwitchCase" value="true" />
        module>

        
        
        <module name="EmptyStatement" />
        
        <module name="MagicNumber">
            <property name="tokens" value="NUM_DOUBLE, NUM_INT" />
        module>
        
        <module name="RedundantThrows" />
        
        <module name="StringLiteralEquality" />
        
        <module name="NestedIfDepth">
            <property name="max" value="3" />
        module>
        
        <module name="NestedTryDepth">
            <property name="max" value="2" />
        module>
        
        <module name="SuperClone" />
        
        <module name="SuperFinalize" />
        
        <module name="IllegalCatch">
            <property name="illegalClassNames" value="java.lang.Exception" />
        module>
        
        <module name="PackageDeclaration" />
        
        <module name="ReturnCount">
            <property name="max" value="10" />
            <property name="format" value="^$" />
        module>
        
        <module name="DeclarationOrder" />
        
        <module name="MultipleVariableDeclarations" />
        
        <module name="UnnecessaryParentheses" />

        
        
        <module name="GenericIllegalRegexp">
            <property name="format" value="System\.out\.println" />
            <property name="ignoreComments" value="true" />
        module>
        
        <module name="UpperEll" />
        
        <module name="ArrayTypeStyle" />
        
        <module name="Indentation" />
    module>
module>