Android Studio Plugin 插件开发教程(二) —— 插件SDK中的常用对象介绍

项目源码

https://github.com/boredream/AndroidDatabaseGeneratorPlugin

系列教程

Android Studio Plugin 插件开发教程(一) —— 开发你的第一个插件

Android Studio Plugin 插件开发教程(二) —— 插件SDK中的常用对象介绍

Android Studio Plugin 插件开发教程(三) —— 制作一个自动生成数据库代码的插件

Android Studio Plugin 插件开发教程(四) —— 为自动生成数据库代码的插件添加UI


先树立一个概念,AS里项目的一切都可以视为对象,比如整个项目,项目里的每个文件,文件里的每个方法、每行语句等等都是一个对象。我们插件SDK的开发,主要工作就是针对这一个个的对象的分析和处理

下面开始介绍几个主要的对象类

Virtual File

虚拟文件类。
可以当做Java开发中的File对象理解,概念比较类似

获取方法
  • 通过Action获取: event.getData(PlatformDataKeys.VIRTUAL_FILE).
    这个也是之前教程(一)中的获取方法
  • 通过本地文件路径获取: LocalFileSystem.getInstance().findFileByIoFile()
  • 通过PSI file获取: psiFile.getVirtualFile()
  • 通过document获取: FileDocumentManager.getInstance().getFile()
用处

传统的文件操作方法这个对象都支持,比如获取文件内容,重命名,移动,删除等


PSI File

PSI系统下的文件类。

获取方法
  • 通过Action获取: e.getData(LangDataKeys.PSI_FILE).
  • 通过VirtualFile获取: PsiManager.getInstance(project).findFile()
  • 通过document获取: PsiDocumentManager.getInstance(project).getPsiFile()
  • 通过文件中的Element元素获取: psiElement.getContainingFile()
    如果要通过名字获取,请使用 FilenameIndex.getFilesByName(project, name, scope)
用处

作为PSI系统中的一个元素,可以使用PSI Element的各种具体方法


看到这里肯定很多人一脸迷惑,这俩File有啥区别?PSI是啥?Element又是啥?

什么是PSI系统?

PSI 是 Program Structure Interface 的简写。从名字可以看出来它是一个接口,相当于把项目中的一切都封装了起来,比如类、方法、语句等,让他们都成为了同一个系统内的实现。封装的对象类都统一加了个前缀比如PsiClass、PsiMethod等。

Virtual File 和 PSI File的区别?

如果学过Dom和Parse解析就很好理解了,Virtual File就是xml文件本身的一个抽象对象。而PSI File就类似于Dom下xml文件解析成的Document对象,虽然也是“文件”,但是特殊封装过的~ 这个PsiFile是整个PSI系统下的文件对象,和PSI下的其他Element元素相通~

PSI Element是什么?

PSI Element是PSI系统下不同类型对象的一个统称,是基类。
比如之前提到的PsiMethod、PsiClass等等都是一个个具体的PsiElement实现。


可能还会有点迷惑,下面写个demo帮助理解。
我们通过ActionEvent的getData方法,传入对应KEY获取PsiFile(Action类创建参考上篇教程),然后遍历PsiFile文件下所有的子级元素,打印出来(日志显示在开发插件的IDE的控制台)
注意,这个直接获取的PsiFile默认为当前我们当前所选的文件

@Override
public void actionPerformed(AnActionEvent e) {
    PsiFile file = e.getData(PlatformDataKeys.PSI_FILE);
    for (PsiElement psiElement : file.getChildren()) {
        System.out.println(psiElement);
    }
}

代码run起来
运行起来的IDE我们新建一个Android Project,默认主页面代码如下

插件测试项目

然后在菜单中 Code | Database Generate 调用我们编写的插件
运行结果日志如下:

PsiPackageStatement:com.boredream.plugindemo
PsiWhiteSpace
PsiImportList
PsiWhiteSpace
PsiClass:MainActivity
PsiWhiteSpace

这里把MainActivity文件下所有的子级Element都列出来了(只遍历直接子级)
看名字就能知道意思,PsiPackageStatement是包名语句,PsiClass是类。。。甚至还有PsiWhiteSpace,空白都专门有个类型啊!细致!

这里不同的Element还有自己对应的特殊方法,比如PsiClass就和Java中的Class类似,可以获取Field、Method等。下面我们再简单改造下Demo,获取MainActivity文件中Class里面的元素。

@Override
public void actionPerformed(AnActionEvent e) {
    PsiFile file = e.getData(PlatformDataKeys.PSI_FILE);
    for (PsiElement psiElement : file.getChildren()) {
        if(psiElement instanceof PsiClass) {
            PsiClass clazz = (PsiClass) psiElement;
            PsiMethod method = clazz.getMethods()[0];
            System.out.println(method.getName());
            System.out.println(method.getParameterList().getText());
        }
    }
}

同样,再次run项目,然后调用插件
运行结果日志如下:

onCreate
(Bundle savedInstanceState)

这次我们遍历获取了PsiClass类对象,然后获取它内部的第一个方法,并打印方法的名字和方法参数的文字

本篇教程结束~
下一章,我们将开撸 自动生成数据库插件代码的实战~
然后一边写插件一边再学习新的内容

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

推荐阅读更多精彩内容