1

我正在为 SonarQube 开发一个插件，以便从 .xml 文件中导入规则。到目前为止，这已经完成，它们确实被导入到 SonarQube 实例中并显示在“规则”下。尽管正在创建质量配置文件，但没有将所有导入的规则添加到其中，我不明白为什么。

我不想一一添加；我正在寻找一种方法，将它们从 .xml 文件导入后直接添加到创建的配置文件中。配置文件只需使用以下命令创建：

public class MyProfile extends ProfileDefinition {
    @Override
    public RulesProfile createProfile(ValidationMessages validation) {
        return RulesProfile.create("QP", "Java");
    }
}

以下是我怀疑会发生这种情况的一些方法代码：

public class MyRules extends RulesDefinition {

public void define(Context context) {
    List<RulePack> rulePacks = this.rulePackParser.parse();
    parseXml(context);                                                      
    parseRulePacks(context, rulePacks);
    for (NewRepository newRepository : newRepositories.values()) {
        newRepository.done();
    }
}

private void parseXml(Context context) {
    for (Language supportedLanguage : languages.all()) {
        InputStream rulesXml = this.getClass().getResourceAsStream("/rules-TESTE.xml");
        if (rulesXml != null) {
            NewRepository repository = getRepository(context, supportedLanguage.getKey());
            xmlLoader.load(repository, new BufferedReader(new InputStreamReader(rulesXml)));
            repository.done();
        }
    }
}

private void parseRulePacks(Context context, List<RulePack> rulePacks) {
    for (RulePack rulePack : rulePacks) {
        for (AppScanRule rule : rulePack.getRules()) {
            String sqLanguageKey = convertToSQ(rulePack.getRuleLanguage(rule));
            if (this.languages.get(sqLanguageKey) != null && isAnInterestingRule(rule)) {
                processRule(context, rulePack, rule, sqLanguageKey);
            }
        }
    }
}
}

提前致谢。

4

1 回答 1

1

编辑说明：实际将规则添加到质量配置文件的描述过程可以被视为一种解决方法，因为当时 SonarQube 的引擎存在一个未解决的问题，不允许一次访问所有规则以便轻松添加到所需的质量配置文件（可以在此处查看此问题）。因此，对于 5.6 的版本，可以这样完成：

  • 自己实现了一个扩展ProfileDefinition的类；
  • 覆盖该方法public RulesProfile createProfile(ValidationMessages messages)并创建配置文件对象RulesProfile profile = RulesProfile.create();
  • 在该方法上，通过（findAll 是被破坏的方法）获取所有规则Collection<Rule> rules = ruleFinder.findAll(RuleQuery.create().withRepositoryKey(key-of-the-repository-with-the-desired-rules));

  • 通过以下方式激活配置文件上的规则：

    for(Rule rule : rules) { profile.activateRule(rule, null); }

  • 最后，可以设置一些定义，例如配置文件的语言或名称。之后返回新创建的配置文件对象：

    profile.setLanguage("Java"); profile.setName("My Profile"); return profile;

所以我能够解决这个问题，但采用了非常不同的方法。为了使用我的新规则添加质量配置文件，我使用了 SonarQube 的 REST Web API docs.sonarqube.org/display/DEV/Web+Service+API。我用于向/从 API 发送/接收请求的客户端是Postman。可用的命令也记录在nemo.sonarqube.org中。

在一些失败之后我发现这个过程似乎有一些使用限制。为了让这个工作，我必须：

  • 首先，在我在问题中给出的插件代码中，我必须使用类RulesDefinitionXmlLoader加载包含规则的 .XML 文件，方法如下：

    xmlLoader.load(repository, new BufferedReader(newInputStreamReader(rulesXml)));

  • 这个过程我真的很甜蜜，你可以很容易地加载你的规则。您所要做的就是确保包含规则的 .XML 文件遵循以下标准模板：

    <rules>
    <rule>
        <repositoryKey>java-key</repositoryKey>
        <key>1</key>
        <internalKey> da-rule-name-1</internalKey>
        <name> da-rule-name </name>
        <description>da-description </description>
   </rule>
</rules>

这里主要关注的是repositoryKey，因为其余列出的字段是强制性的。您必须确保此处使用的密钥与用于添加质量配置文件的密钥相同（我将在接下来展示）。此键在创建存储库时在扩展 RulesDefinition（我在问题中提供的最重要的代码）的类中定义。

如果有帮助，您还可以使用对 Web API 的请求来列出所有存储库，这样您就可以确保使用的密钥是正确的： 在此处输入图像描述

  • 创建一个与前一个类似的 .XML 文件，但包含以下信息。这是 REST Web API 将用于创建质量配置文件的文件：

    <profile>
    <name>da-profile-name</name>
    <language>java</language>
    <rules>
        <rule>
            <repositoryKey>java-key</repositoryKey>
            <key>1</key>
            <internalKey> da-rule-name-1</internalKey>
            <name> da-rule-name </name>
            <description>da-description </description>
       </rule>
    </rules>
</profile>

  • 最后，您所要做的就是使用这个创建的第二个文件将请求发送到 Web API。为此，您可以像我说的那样使用 Postman（如果您像我一样对使用 REST API 的知识很少或一无所知）或命令提示符（在这种情况下需要安装 Curl）。在邮递员中：

    1. 将请求设置为“Post”并添加 URL（假设 SonarQube 在本地机器中并监听默认端口）：http://localhost:9000/api/qualityprofiles/restore

    2. 设置“授权”。默认为"admin"/"admin"；

    3. 在“Body”处，将“key”=“backup”和“value”设置为文件（选择向下箭头）并选择创建的第二个文件（带有规则和额外标签的文件）。

请求配置

发送请求，如果一切顺利，您应该能够在底部窗口中看到成功导入规则的数量！

于 2016-04-02T15:28:22.867 回答