CheckStyle示例

<?xml version="1.0"?>
<!DOCTYPE module PUBLIC
          "-//Puppy Crawl//DTD Check Configuration 1.3//EN"
          "http://checkstyle.sourceforge.net/dtds/configuration_1_3.dtd">

<!--
    Checkstyle configuration that checks the Google coding conventions from Google Java Style
    that can be found at https://google.github.io/styleguide/javaguide.html.

    Checkstyle is very configurable. Be sure to read the documentation at
    http://checkstyle.sf.net (or in your downloaded distribution).

    To completely disable a check, just comment it out or delete it from the file.

    Authors: Max Vetrenko, Ruslan Diachenko, Roman Ivanov.
 -->

<module name = "Checker">
    <property name="charset" value="UTF-8"/>
    <property name="severity" value="warning"/>
    <property name="basedir" value="${basedir}"/>
    <property name="fileExtensions" value="java, properties, xml"/>
    <!-- 檢查文件的長度，default max=20000 -->
    <module name="FileLength"/>
    <!-- 檢查文件中是否含有'\t' -->
    <module name="FileTabCharacter">
        <property name="eachLine" value="false"/>
        <property name="fileExtensions" value="all files"/>
    </module>
    <module name="TreeWalker">
        <!-- 必須導(dǎo)入完成的類名，不能使用*類型導(dǎo)入 -->
        <module name="AvoidStarImport"/>
        <!-- 檢查是否從非法的包中導(dǎo)入了類 illegalPkgs: 定義非法的包名稱-->    
        <module name="IllegalImport"/>
        <!-- 檢查是否導(dǎo)入了不必顯示導(dǎo)入的類-->    
        <module name="RedundantImport"/>    
        <!-- 檢查是否導(dǎo)入的包沒有使用-->    
        <module name="UnusedImports"/>  
        
        <!-- Checks for whitespace             
        <module name="EmptyForIteratorPad"/>  
        <module name="MethodParamPad"/>  
        <module name="NoWhitespaceAfter"/>  
        <module name="NoWhitespaceBefore"/>  
        <module name="OperatorWrap"/>  
        <module name="ParenPad"/>  
        <module name="TypecastParenPad"/>  
        <module name="WhitespaceAfter"/>  
        <module name="WhitespaceAround"/>  
        -->  
        <!-- 檢查類和接口的javadoc 默認(rèn)不檢查author 和version tags         
            authorFormat: 檢查author標(biāo)簽的格式  
            versionFormat: 檢查version標(biāo)簽的格式  
            scope: 可以檢查的類的范圍寥粹，例如：public只能檢查public修飾的類，private可以檢查所有的類  
            excludeScope: 不能檢查的類的范圍殃恒，例如：public，public的類將不被檢查得问，但訪問權(quán)限小于public的類仍然會(huì)檢查页藻，其他的權(quán)限以此類推  
            tokens: 該屬性適用的類型，例如：CLASS_DEF,INTERFACE_DEF 
        -->  
        <module name="JavadocType">    
            <property name="authorFormat" value="\S"/>    
            <property name="scope" value="private"/>          
            <property name="tokens" value="CLASS_DEF,INTERFACE_DEF"/>    
        </module>  
        <!-- 檢查方法的javadoc的注釋  
            scope: 可以檢查的方法的范圍贰军，例如：public只能檢查public修飾的方法玻蝌，private可以檢查所有的方法  
            allowMissingParamTags: 是否忽略對(duì)參數(shù)注釋的檢查  
            allowMissingThrowsTags: 是否忽略對(duì)throws注釋的檢查  
            allowMissingReturnTag: 是否忽略對(duì)return注釋的檢查 
        -->  
        
        <module name="JavadocMethod">    
            <property name="scope" value="public"/>    
            <property name="allowMissingParamTags" value="false"/>    
            <property name="allowMissingThrowsTags" value="false"/>    
            <property name="allowMissingReturnTag" value="false"/>    
            <property name="tokens" value="METHOD_DEF"/>    
            <property name="allowUndeclaredRTE" value="true"/>    
            <property name="allowThrowsTagsForSubclasses" value="true"/>
            <!--允許get set 方法沒有注釋-->  
            <property name="allowMissingPropertyJavadoc" value="true"/>  
        </module>
        
        <!-- 檢查類變量的注釋  
            scope: 檢查變量的范圍，例如：public只能檢查public修飾的變量谓形，private可以檢查所有的變量 
        -->      
        <module name="JavadocVariable">    
          <property name="scope" value="public"/>    
        </module>    
        <!-- 
            option: 定義左大括號(hào)'{'顯示位置灶伊，eol在同一行顯示疆前，nl在下一行顯示    
            maxLineLength: 大括號(hào)'{'所在行行最多容納的字符數(shù)    
            tokens: 該屬性適用的類型寒跳，例：CLASS_DEF,INTERFACE_DEF,METHOD_DEF,CTOR_DEF 
        -->    
        <!--
        <module name="LeftCurly">   
            <property name="option" value="nl"/>  
        </module>
        -->
        <!-- 
            Checks the placement of right curly braces ('}') for  else, try, and catch tokens. The policy to verify is specified using property  option.     
            option: 右大括號(hào)是否單獨(dú)一行顯示    
            tokens: 定義檢查的類型  
        -->    
        <!--
        <module name="RightCurly">      
            <property name="option" value="alone"/>     
        </module>  
        -->
        <!-- NeedBraces 檢查是否應(yīng)該使用括號(hào)的地方?jīng)]有加括號(hào)    
            tokens: 定義檢查的類型 
        -->    
        <module name="NeedBraces"/>
        <!-- 檢查在重寫了equals方法后是否重寫了hashCode方法 -->   
        <module name="EqualsHashCode"/>
        
        <module name="LocalVariableName">
            <property name="tokens" value="VARIABLE_DEF"/>
            <property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>
            <message key="name.invalidPattern"
             value="Local variable name ''{0}'' must match pattern ''{1}''."/>
        </module>
        
        <module name="LineLength">
            <property name="max" value="100"/>
            <property name="ignorePattern" value="^package.*|^import.*|a href|href|http://|https://|ftp://"/>
        </module>
        
         <module name="PackageName">
            <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/>
            <message key="name.invalidPattern"
             value="Package name ''{0}'' must match pattern ''{1}''."/>
        </module>
        
        <module name="TypeName">
            <message key="name.invalidPattern"
             value="Type name ''{0}'' must match pattern ''{1}''."/>
        </module>
        
        <module name="MethodName">
            <property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9_]*$"/>
            <message key="name.invalidPattern"
             value="Method name ''{0}'' must match pattern ''{1}''."/>
        </module>
        
        <module name="MemberName">
            <property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9]*$"/>
            <message key="name.invalidPattern"
             value="Member name ''{0}'' must match pattern ''{1}''."/>
        </module>
        <module name="ParameterName">
            <property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>
            <message key="name.invalidPattern"
             value="Parameter name ''{0}'' must match pattern ''{1}''."/>
        </module>
        <!-- 檢查代碼的進(jìn)縮-->
        <!--
        <module name="Indentation">
            <property name="basicOffset" value="2"/>
            <property name="braceAdjustment" value="0"/>
            <property name="caseIndent" value="2"/>
            <property name="throwsIndent" value="4"/>
            <property name="lineWrappingIndentation" value="4"/>
            <property name="arrayInitIndent" value="2"/>
        </module>
        -->
        <module name="ArrayTypeStyle"/>
        <module name="MagicNumber"/>     
        <module name="TodoComment"/>
        <module name="UpperEll"/>
        <module name="ParameterNumber">        
            <property name="max" value="5"/>                
        </module>
        <module name="MethodLength">    
            <property name="max" value="300"/>                   
        </module>           
        <!--- 字符串比較必須使用 equals() -->     
        <module name="StringLiteralEquality"/>       
        <!-- if-else嵌套語句個(gè)數(shù) 最多4層 -->  
        <module name="NestedIfDepth">          
            <property name="max" value="3"/>           
        </module>       
        <!-- try-catch 嵌套語句個(gè)數(shù) 最多2層 -->  
        <module name="NestedTryDepth">    
            <property name="max" value="2"/>           
        </module>    
        <!-- 返回個(gè)數(shù) -->     
        <module name="ReturnCount">          
            <property name="max" value="5"/>    
            <property name="format" value="^$"/>            
        </module>   
        <module name="AvoidEscapedUnicodeCharacters">
            <property name="allowEscapesForControlCharacters" value="true"/>
            <property name="allowByTailComment" value="true"/>
            <property name="allowNonPrintableEscapes" value="true"/>
        </module>
        <module name="OneStatementPerLine"/>
        <module name="MultipleVariableDeclarations"/>
        <module name="NoFinalizer"/>
        <module name="OverloadMethodsDeclarationOrder"/>
        <module name="AnnotationLocation">
            <property name="id" value="AnnotationLocationMostCases"/>
            <property name="tokens" value="CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, CTOR_DEF"/>
        </module>
        <module name="AnnotationLocation">
            <property name="id" value="AnnotationLocationVariables"/>
            <property name="tokens" value="VARIABLE_DEF"/>
            <property name="allowSamelineMultipleAnnotations" value="true"/>
        </module>
        <module name="EmptyCatchBlock">
            <property name="exceptionVariableName" value="expected"/>
        </module>
    </module>
</module>