`

定制CheckStyle

阅读更多

CheckStyle的最新发布版本中,有一个对于SunJava编码规范的配置文件信息。但是,其中有很多条目并不一定符合项目开发的需要。就算是对于很多优秀的开源项目,按照这个规范来进行检查,也会出现成千上万的错误。这就是为什么需要定制CheckStyle的原因。

CheckStyle的执行基于XML配置文件,它的主要组成部分是:
  ·Module:整个配置文件就是一棵Module树。根节点是Checker Module
  ·Properties:它来决定一个Module如何进行检查。每个Module都有一个默认值,如果不满足开发需求,可以设定其它的值。

  下面是一个示例:

module name="MethodLength"

property name="max" value="60"/
/module

它表示,如果方法或者构造函数的长度超过60行,CheckStyle就会报错。而默认值是150行。一般情况下,与IDE集成在一起使用的时候,点击出错的条目,可以跳转到相应的代码。

对于所有的模块来书,如果有这个模块则说明检测这一项,没有则不检测这一项。所有的模块中,其ROOT必须为Checker。配置文件中某些元素的具体讲解如下。

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE module PUBLIC "-//Puppy Crawl//DTD CheckeConfiguration 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"/>

     -->

     <!-- 检验每个文件末尾是否有一个空行,在UNIT机器上是有的,在CVS上如果没有会有警告的-->

     <!-- 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 commentsefor 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"evalue="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" />

         <!-- 有一个bug,比如i++居然都不认

         <module name="IllegalToken"/>

         -->

         <module name="IllegalTokenText" />

         <module name="IllegalType" />

         <module name="InnerAssignment" />

         <!--检查直接数

         <module name="MagicNumber"/>

         检查是否有构造子

         <module name="MissingCtor"/>

         -->

 

更多checkstyle资料下载:

分享到:
评论

相关推荐

    Checkstyle 使用手册 以及常用方法

    在实际使用中,你可以根据团队的编码规范定制Checkstyle规则,并通过修改配置文件来启用或禁用特定检查。此外,Checkstyle的输出结果通常包括文件、行号、错误类型和修复建议,方便开发人员快速定位和修复问题。 总...

    checkstyle.zip

    总的来说,"checkstyle.zip"是开发者提升代码质量的好帮手,通过使用和定制Checkstyle,可以确保代码遵循最佳实践,降低bug出现的几率,同时也提高了代码的可读性和团队间的协作效率。在实际开发过程中,应充分利用...

    myeclipse整合checkstyle详细文档

    为了提高效率,可以定制Checkstyle的输出格式,例如生成XML或HTML报告,方便团队成员查看和分析。另外,可以设置忽略某些不重要的规则,或者根据错误的严重程度调整其优先级。 总结,MyEclipse整合Checkstyle能够...

    CheckStyle使用手册

    开发者可以根据团队需求定制CheckStyle规则,如特定的命名约定、代码格式化要求等。自定义规则可以通过扩展CheckStyle内置的检查器或者编写新的检查器实现。 5. **运行CheckStyle** 运行CheckStyle有两种方式:...

    Code Standard & CheckStyle

    3.4 定制CheckStyle CheckStyle允许团队根据自身需求定制规则集,这样可以更好地符合团队的编码习惯和项目特定的要求。 4. CheckStyle应用的最佳实践 1) 在项目初期就确定并实施CheckStyle规则,以保持代码一致性...

    checkstyle-plugin-master

    通过深入研究 "checkstyle-plugin-master" 项目的源代码,开发者可以学习到如何编写和定制 Checkstyle 规则,如何创建和集成插件,以及如何在实际项目中实施代码质量控制。这对于提升团队的代码质量和开发效率是非常...

    CheckStyle的安装与配置[归纳].pdf

    在实际使用中,开发团队可能需要根据自己的项目需求定制 CheckStyle 的配置。你可以创建自己的 XML 配置文件,例如命名为 `mycompany_checks.xml`。配置文件的内容包括各种检查规则,如 `&lt;module&gt;` 元素定义一个检查...

    JoyCheckStyle

    2. **配置规则**:根据项目需求,定制Checkstyle的配置文件(通常为checkstyle.xml),定义要检查的规则。 3. **运行检查**:在开发过程中,定期运行Checkstyle检查,查看报告,修复不符合规范的代码。 4. **集成CI/...

    IDEA CheckStyle插件离线安装包 checkstyle-idea-4.10.0.zip

    4. **可定制化**: CheckStyle允许用户根据项目需求自定义规则,适应不同项目的编码标准。 5. **跨平台**: CheckStyle不仅适用于IntelliJ IDEA,还支持Eclipse、NetBeans等其他IDE,以及命令行工具。 总结来说,...

    checkstyle

    Checkstyle的配置文件(通常是checkstyle.xml)包含了具体的编码规范,这些规则可以根据团队的需求进行定制。配置文件中可以定义各种检查,如命名约定(类名、方法名、变量名)、注释要求、空格和缩进规则、非法代码...

    代码检查 CheckStyle-IDEA

    IntelliJ IDEA 是一个强大的 Java 和 Android 开发 IDE,提供了丰富的功能和高度可定制性。通过安装 CheckStyle 插件,开发者可以在 IDEA 中直接运行 CheckStyle 检查,及时发现不符合编码规范的代码行,并提供快速...

    checkstyle-checkstyle-8.26.zip

    CheckStyle是一款著名的开源代码质量检查工具,主要用于Java项目的编码...通过解压并研究`checkstyle-checkstyle-8.26.zip`,开发者可以深入了解其工作原理,并根据自己的需求定制规则,打造更高质量的Java应用程序。

    Checkstyle定制检查标准格式

    Checkstyle定制检查标准格式,具体的格式定制

    eclipse离线安装checkStyle插件--附带插件安装包

    CheckStyle提供了一套可定制的编程规则,包括命名规范、注释规范、代码结构等,可以自动检查代码是否符合这些规则,从而避免人为错误,提高代码质量。对于大型项目或者团队协作来说,使用CheckStyle是确保代码风格...

    checkStyle java代码检查工具

    5. **自定义规则**:开发者可以根据团队的编码规范,创建自己的 CheckStyle 配置文件(.xml),定制检查规则。 6. **命令行工具**:除了集成到 IDE 中,CheckStyle 还提供了一个命令行工具,方便在持续集成服务器上...

    IDEA CheckStyle插件

    此外,CheckStyle的灵活性允许开发者根据自己的项目需求调整和扩展规则,实现定制化的代码风格检查。 总之,IDEA CheckStyle插件是提升代码质量和开发效率的得力助手,它通过严谨的代码规范检查,帮助开发者养成...

    checkstyle-idea,intellij idea的checkstyle插件.zip

    这些规则可以针对整个项目或单个模块进行定制,让代码审查更加高效。 在实际开发中,Checkstyle插件会在每次保存代码时自动运行检查,如果有不符合规则的地方,会在代码行旁边标出警告或错误提示。此外,还可以通过...

    checkstyle 教程

    CheckStyle的强大之处在于其高度的可定制性。用户可以根据团队的编码规范创建自己的规则集,并将其导入到CheckStyle中。 1. **准备自定义规则XML**: - 通常情况下,自定义规则XML文件由项目团队提供,包含了项目...

    开发规范

    通过定制checkstyle.xml,团队可以定义自己的代码风格规则,包括但不限于: 1. **命名规范**:如类名、方法名、变量名应遵循驼峰命名法,常量全大写等。 2. **代码格式化**:强制代码缩进、换行、空格使用的一致性...

Global site tag (gtag.js) - Google Analytics