千家信息网

sonarqube中怎么添加阿里java开发规范

发表于:2024-09-24 作者:千家信息网编辑
千家信息网最后更新 2024年09月24日,这篇文章给大家介绍sonarqube中怎么添加阿里java开发规范,内容非常详细,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。拉取sonar-pmd源码,切换到3.2.1。修改pom文件添加p
千家信息网最后更新 2024年09月24日sonarqube中怎么添加阿里java开发规范

这篇文章给大家介绍sonarqube中怎么添加阿里java开发规范,内容非常详细,感兴趣的小伙伴们可以参考借鉴,希望对大家能有所帮助。


  1. 拉取sonar-pmd源码,切换到3.2.1。修改pom文件添加p3c-pmd依赖:

        com.alibaba.p3c    p3c-pmd    2.0.0


  2. 开始配置阿里Java规范,此处演示配置规则:单个方法的总行数不超过80行,规则名为MethodTooLongRule,此规则名来源于p3c项目p3c\p3c-pmd\src\main\resources\rulesets\java\ali-other.xml文件中配置的规则名。

  3. 首先在sonar-pmd项目sonar-pmd-plugin\src\main\resources\org\sonar\l10n\pmd\rules目录下新建pmd-p3c目录用于存放规则说明html,然后新建MethodTooLongRule.html, 添加内容如下:

    单个方法的总行数不超过80行。

    说明:包括方法签名、结束右大括号、方法内代码、注释、空行、回车及任何不可见字符的总行数不超过80行。


  4. 修改sonar-pmd项目sonar-pmd-plugin\src\main\resources\org\sonar\l10n\pmd.properties配置文件,添加MethodTooLongRule规则名如下:

    rule.pmd.MethodTooLongRule.name=[p3c]The total number of lines for a method should not be more than 80.


  5. 在sonar-pmd项目sonar-pmd-plugin\src\main\resources\org\sonar\plugins\pmd目录下新建rules-p3c.xml规则文件并添加MethodTooLongRule规则配置如下:

        MAJOR        CODE_SMELL    other


  6. 修改sonar-pmd项目sonar-pmd-plugin\src\main\resources\com\sonar\sqale\pmd-model.xml配置文件,在文件末尾标签前添加如下代码:

        P3C-PMD    p3c-pmd            P3C_PMD        p3c_pmd                       pmd        MethodTooLongRule                  remediationFunction          CONSTANT_ISSUE                                    offset          2          min                  


  7. 添加p3c规则的引入,修改PmdRulesDefinition.java文件,在define方法内添加p3c规则库

        @Override    public void define(Context context) {        NewRepository repository = context                .createRepository(PmdConstants.REPOSITORY_KEY, PmdConstants.LANGUAGE_KEY)                .setName(PmdConstants.REPOSITORY_NAME);        extractRulesData(repository, "/org/sonar/plugins/pmd/rules.xml", "/org/sonar/l10n/pmd/rules/pmd");        // 新增        extractRulesData(repository, "/org/sonar/plugins/pmd/rules-p3c.xml", "/org/sonar/l10n/pmd/rules/pmd-p3c");        repository.done();    }


  8. 使用mvn package -Dmaven.test.skip=true打包即可,如果规则的描述文件html中包含中文内容,那么注意文件编码需要是utf-8。

  9. 把sonar-pmd-plugin\target目录下的sonar-pmd-plugin-3.2.1.jar放到 sonarqube服务/extensions/plugins目录下重启服务。

  10. 登陆sonarqube在质量配置页面点击【创建】按钮新建p3c质量,语言选Java,点击【创建】后跳转到该质量配置的详情界面,然后点击【更多激活规则】,在搜索规则中搜索p3c,然后点击【批量修改】,点击【应用】到刚新建的质量配置, 然后回到【质量配置】页面,将该质量配置Set as Default【设为默认】,然后就可以分析项目质量了。

问题:

1. 分析失败提示缺失类com/google/gson/Gson,在sonar-pmd项目pom文件添加如下依赖:

      com.google.code.gson      gson      2.8.5

其他:

1. 规则说明html内容来源于p3c\p3c-pmd\src\main\resources下的message.xml文件内配置的msg和desc内容,添加示例代码使用

标签,如果代码内用泛型或代码为xml配置请使用标签,示例如下:</p><pre><h3>Negative example :</h3><pre>  <xmp>   List<String> list = new ArrayList<String>();   list.add("22");   //warn   List<String> test = (ArrayList<String>) list.subList(0, 1);   

2.规则名来源于p3c\p3c-pmd\src\main\resources下的message_en.xml的配置的规则的msg内容,但存在部分msg过长导致sonar重启失败,请酌情删减。

3. rules-p3c.xml添加规则类型type暂时用了CODE_SMELL和BUG

4. rules-p3c.xml添加规则内的configKey配置要与p3c\p3c-pmd\src\main\resources\rulesets\java目录下的规则配置文件文件名和规则名一一对应。

关于sonarqube中怎么添加阿里java开发规范就分享到这里了,希望以上内容可以对大家有一定的帮助,可以学到更多知识。如果觉得文章不错,可以把它分享出去让更多的人看到。

0