在运行自定义检查 checkstyle 方面需要帮助

Question

我想运行在 java 程序 samples/Test.java 上用 checkstyle 实现一个简单的自定义检查。我遇到了以下错误。

com.puppycrawl.tools.checkstyle.api.CheckstyleException: cannot initialize module TreeWalker - Unable to instantiate 'com.checkstyle.checks.IllegalExceptionThrowsCheck' class, it is also not possible to instantiate it as null.

对不起，尽管错误是有道理的，但我无法在修复它方面取得任何进展。我已经 post 编辑了 post 末尾的完整错误。下面是自定义检查的实现。 IllegalExceptionThrowsCheck.java

package com.checkstyle.checks;

import java.util.Arrays;
import java.util.List;

import com.puppycrawl.tools.checkstyle.api.Check;
import com.puppycrawl.tools.checkstyle.api.DetailAST;
import com.puppycrawl.tools.checkstyle.api.TokenTypes;

public final class IllegalExceptionThrowsCheck extends Check {

    List<String> illegalExceptionThrows;

    /** {@inheritDoc} */
    public int[] getDefaultTokens() {
       return new int[] { TokenTypes.LITERAL_THROWS };
    }

    /** {@inheritDoc} */
    public int[] getRequiredTokens() {
       return getDefaultTokens();
    }

    /** {@inheritDoc} */
   public void visitToken(DetailAST aDetailAST) {
      DetailAST identDetailAST = aDetailAST.findFirstToken(TokenTypes.IDENT);
      if (identDetailAST == null) {
         return;
      }
      if (illegalExceptionThrows.contains(identDetailAST.getText())) {
           log(aDetailAST, "Illegal Throws Clause  -> "
                + identDetailAST.getText());
      }
  }

  public void setIllegalExceptionThrows(String illegalExceptionThrowsStr) {
      this.illegalExceptionThrows =   Arrays.asList(illegalExceptionThrowsStr
            .split(","));
   }
}

And the checkstyle configuration is custom-checkstyle.xml

   <?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">
   <module name="Checker">
       <property name="severity" value="error" />
       <module name="TreeWalker">
        <property name="severity" value="error" />
        <module name="com.checkstyle.checks.IllegalExceptionThrowsCheck">
            <property name="severity" value="error" />
            <property name="illegalExceptionThrows" value="Exception" />
        </module>
       </module>
   </module>

The package structure is

Project
 |
 |->src
 |   |
 |   |->com
 |      |
 |      |->checkstyle
 |            |
 |            |-> checks
 |                  |
 |                  |-> IllegalExceptionThrowsCheck.java
 |
 |
 |-> lib
 |   |
 |   |->checkstyle-8.10.1-all.jar
 |
 |
 |-> Samples
       |
       | -> Test.java

The command I ran to execute the check on java program was

java -jar lib/checkstyle-8.10.1-all.jar com.puppycrawl.tools.checkstyle.Main -c custom_check.xml samples/Test.java

任何评论都会非常有帮助。

APPENDIX

完整的错误日志

com.puppycrawl.tools.checkstyle.api.CheckstyleException: 无法初始化模块 TreeWalker - 无法实例化 'com.checkstyle.checks.IllegalExceptionThrowsCheck' class，也无法将其实例化为 null。请重新检查 class 名称是否指定为规范名称或阅读如何配置短名称使用 http://checkstyle.sourceforge.net/config.html#Packages。还请重新检查提供给 Checker 的 ClassLoader 是否配置正确。在 com.puppycrawl.tools.checkstyle.Checker.setupChild(Checker.java:460) 在 com.puppycrawl.tools.checkstyle.api.AutomaticBean.configure(AutomaticBean.java:198) 在 com.puppycrawl.tools.checkstyle.Main.runCheckstyle(Main.java:550) 在 com.puppycrawl.tools.checkstyle.Main.runCli(Main.java:465) 在 com.puppycrawl.tools.checkstyle.Main.main(Main.java:219) Caused by: com.puppycrawl.tools.checkstyle.api.CheckstyleException: Unable to instantiate 'com.checkstyle.checks.IllegalExceptionThrowsCheck' class, 也无法实例化为null。请重新检查 class 名称是否指定为规范名称或阅读如何配置短名称使用 http://checkstyle.sourceforge.net/config.html#Packages。还请重新检查提供给 Checker 的 ClassLoader 是否配置正确。在 com.puppycrawl.tools.checkstyle.PackageObjectFactory.createModule(PackageObjectFactory.java:208) 在 com.puppycrawl.tools.checkstyle.TreeWalker.setupChild(TreeWalker.java:151) 在 com.puppycrawl.tools.checkstyle.api.AutomaticBean.configure(AutomaticBean.java:198) 在 com.puppycrawl.tools.checkstyle.Checker.setupChild(Checker.java:455) ... 还有 4 个 Checkstyle 以 1 个错误结尾。

Answer 1

class IllegalExceptionThrowsCheck extends Check {

首先，基数class不再是Check。是AbstractCheck。 Check 刚才被删除了，你的 CLI 命令说你正在使用 8.10.1，所以我不知道你是怎么得到这个来检查用一个不存在的基础编译 class Check.

java -jar lib/checkstyle-8.10.1-all.jar com.puppycrawl.tools.checkstyle.Main -c custom_check.xml samples/Test.java

其次，由于您没有在此命令行中提及您的 project/jar，因此 checkstyle 将永远找不到您的 class。您只告诉 JVM 关于 checkstyle-8.10.1-all.jar 而不是关于您的项目和它的 class 个文件。

我建议将您的项目打包到一个 jar 中，然后将其包含在您的命令行中。示例：java -classpath MyCustom.jar;checkstyle-8.10.1-all.jar com.puppycrawl.tools.checkstyle.Main -c config.xml Check.java
http://checkstyle.sourceforge.net/cmdline.html#Usage_by_Classpath_update

第三，你可以把你的setter改成：

public void setIllegalExceptionThrows(String... illegalExceptionThrowsStr) {
    this.illegalExceptionThrows = Arrays.asList(illegalExceptionThrowsStr);
}

在 运行 自定义检查 checkstyle 方面需要帮助

Need help in running a custom check in checkstyle

java

checkstyle

在运行自定义检查 checkstyle 方面需要帮助