sonar自定义规则笔记

对于sonar的安装,笔记并未做相关记录,原因很简单,百度一下你就知道;
笔记着重自定义规则开发,个人也是慢慢摸索,一路坎坷,接下来一点点分享,欢迎各路大神批评指正:

1.针对于sonarqube的自定义规则开发,这边是通过IDEA来搭建的环境,对于源码阅读比较舒服。

2.从官方下载了自定义规则的demo,这也就可以开始玩起来。
结构树如图:


image.png

该类实现了接口Plugin


image.png

那么接下来对这个接口分析:
里面只有一个define方法,同时该方法的入参被封装成了一个静态内部类,ok,接下来继续分析:


image.png

在这个静态内部类中定义了一些方法,观察发现,这些方法都是为内部的两个final的参数服务的,足见两个参数的重要,那就一起看看这两个参数吧

image.png

关于第一个SonarRuntime,一个接口


image.png

通过类图发现,只有一个子类SonarRuntimeImpl , (够神奇的,就一个类还用一个接口去抽象替换实体,不过细想就回发现这样做肯定是为了后期对于sonarqube的相关配置和服务升级,同时也保证了java的开闭原则,此处略略略。。。) 进入子类看看


image.png

这里分析应该是和qube服务器相关的设置,对于自定义规则不太感冒,后续在继续研究,返回之前对Plugin的内部静态类的第二个参数: private final List extensions = new ArrayList();


image.png

上边说的第二个参数如图:


image.png

该参数extensions结构是哪个方法和插件入口类中的两个add方法
发现,其目的就是把容器自定义的参数封装到sonar容器中

image.png

下图是入口类的图,上文也有,为了方便阅读,再次复制过来


image.png

是不是都指向了内部的方法,哈哈,接下来对传入的这两个类逐一分析:
MyJavaRulesDefinition 类主要是对视图方面的加载,此处后期补充

MyJavaFileCheckRegistrar: 这个类 ,很有味道,当然也是我们需要着重关心的

image.png
image.png
image.png

结合三张图,你也可以自己去看看,Ruleslist是一个静态工具类,我理解为工厂,不过这里的工厂貌似就是个打包机器,把所有自定义的规则打包到里面,这里有一个特别的地方就是ImmutableList这个容器类的使用,是一个对集合可变性的工具拓展类,谷歌推出的guava工具包,这个工具包之前听说是被jdk8融进来了,此处略过继续略过。。

ok 这些分析结束,后面的就是easy的事情了
自定义规则:
这里随机挑选了一个短一些的代码分析:
这是一个堆类名的规则校验自定义类,类名上有注释,可以阅读:

package org.sonar.samples.java.checks;

import com.sun.xml.internal.ws.api.model.JavaMethod;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.sonar.check.Rule;
import org.sonar.plugins.java.api.JavaFileScanner;
import org.sonar.plugins.java.api.JavaFileScannerContext;
import org.sonar.plugins.java.api.tree.*;

/**
 * 抽象类命名检查
 * 抽象类命名使用 Abstract 或 Base 开头
 *
 */
@Rule(key = "AbstractClassNameCheck")
public class AbstractClassNameCheck extends BaseTreeVisitor implements JavaFileScanner{

    private static final Logger LOGGER = LoggerFactory.getLogger(AbstractClassNameCheck.class);

    private JavaFileScannerContext context;  //用于存储上下文的私有字段:这是用于创建问题的对象
    private JavaMethod method;

    @Override
    public void scanFile(JavaFileScannerContext context) {
        this.context = context;
        scan(context.getTree());
    }

    @Override
    public void visitClass(ClassTree tree) {
        String className = tree.simpleName().name();
        LOGGER.info(" :   " +tree.firstToken().line());
        LOGGER.info(tree.simpleName().name() + "------ " + tree.symbol().isAbstract());
        if(tree.symbol().isAbstract()){
            //判断名称是否以Abstract 或 Base 开头
            String abName = "Abstract";
            String bsName = "Base";
            //判断类名如果小于Abstract 或 Base
            if (className.length() < abName.length() || className.length() < bsName.length()) {
                context.reportIssue(this, tree, "抽象类的名称应首先使用Abstract或Base");
                context.addIssue(tree.firstToken().line(),this,"有点味道儿..");
            } else {
                    //判断是否存在 Abstract 或 Base
                if (!className.contains(abName)) {
                    if (!className.contains(bsName)) {
                        context.reportIssue(this, tree, "抽象类的名称应首先使用Abstract或Base");
                        context.addIssue(tree.firstToken().line(),this,"有点味道儿..");
                    } else {
                        if (className.indexOf(bsName) != 0) {
                            context.reportIssue(this, tree, "抽象类的名称应首先使用Abstract或Base");
                            context.addIssue(tree.firstToken().line(),this,"有点味道儿..");
                        }
                    }
                } else {
                    if (className.indexOf(abName) != 0) {
                        context.reportIssue(this, tree, "抽象类的名称应首先使用Abstract或Base");
                        context.addIssue(tree.firstToken().line(),this,"有点味道儿..");
                    }
                }
            }
        }
        super.visitClass(tree);
    }


    @Override
    public void visitMethod(MethodTree tree) {
        LOGGER.info("Me : "+tree.symbol().name());
        if (tree.symbol().name().equals("test1")) {
            LOGGER.info("xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx");
            context.reportIssue(this,tree,"方法有味道。。。");
        }


        super.visitMethod(tree);
    }
}

解读自定义规则:
通过注解@Rule 来定义规则的key名

image.png

该注解可以有如上图的这些参数

在自定义规则类中,需
extends BaseTreeVisitor implements JavaFileScanner
而对于这两个类,一个是扫描文件,一个是将文件中的内容封装为各个语法树,同时各个语法树也可以拆借为开头语法,结束语法,在定义规则是分别可以拿到相应文段的左边,行号,列号以及内容,通过对坐标内容的比对,来 完成自定义规则的实现
当然还有一个类比较有意思,这里后面用到会继续分析

public static enum Kind implements GrammarRuleKey 这个枚举封装了java文件中所有的相关信息的类信息,比如字段是方法还是变量 ,是静态的吗 等等 , 都是返回该枚举中的一个,通过比对也可以实现一些自定义规则

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,332评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,508评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,812评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,607评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,728评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,919评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,071评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,802评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,256评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,576评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,712评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,389评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,032评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,026评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,473评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,606评论 2 350