IDEA 插件找不到？看这里！那就自己敲一个！

前言

" 大家都经常使用 IDEA 进行开发，肯定会使用一些 IDEA 插件，我之前也写过两个插件，不过已经很久没有更新了，就让它先放着吧！

那小伙伴你是否想亲手写一个插件，或者你是否有一些插件的想法，但是找不到插件。那就自己实现一个吧！ "

创建项目

使用 Gradle 创建

写插件，先从创建项目开始：

File -> New -> Project...

- 这里使用 Gradle，其中 Java 已经默认选中，咱们再额外选择 IntelliJ Platform Plugin。

- 点击 Next ，然后填写项目名称，路径等选项。

- 项目结构

build.gradle 为项目配置文件。

resources/META-INF/plugin.xml 为插件配置文件。

使用 GitHub 模版

访问 https://github.com/JetBrains/intellij-platform-plugin-template
点击 Use this template 创建模版。

Clone 项目到自己本地。

注：模版生成的项目是使用的 Kotlin ，所以这里使用的第一种方式创建。

开始开发

修改 build.gradle 配置文件

原内容如下：

修改后：

代码语言：javascript复制

plugins {
    id 'java'
    id 'org.jetbrains.intellij' version '0.4.15'
}

group 'com.liuzhihang.toolkit'
version '1.0.2'

sourceCompatibility = 1.8

repositories {
    mavenLocal()
    maven { url "https://maven.aliyun.com/repository/public" }
    mavenCentral()
    jcenter()
}

dependencies {
    testCompile group: 'junit', name: 'junit', version: '4.12'
}

// See https://github.com/JetBrains/gradle-intellij-plugin/
intellij {
    version '2019.1.1'
    pluginName 'Copy as Json'
    updateSinceUntilBuild false
    sameSinceUntilBuild false
}
patchPluginXml {
    pluginDescription(file(descriptionFile).text)
    changeNotes(file(changesFile).text)
}

修改 repositories 使用阿里云；
修改 patchPluginXml 使用外置文件；
在根目录下创建 parts 路径，并创建 changeNotes.html、pluginDescription.html 文件。

修改 plugin.xml 插件信息

原内容如下：

修改后：

代码语言：javascript复制

<idea-plugin>
    <id>com.liuzhihang.toolkit.copyasjson</id>
    <name>Copy as Json</name>
    <vendor email="liuzhihangs@qq.com" url="https://liuzhihang.com">Liu ZhiHang</vendor>

    <description><![CDATA[ Description will be added by gradle build]]></description>

    <!-- please see http://www.jetbrains.org/intellij/sdk/docs/basics/getting_started/plugin_compatibility.html
         on how to target different products -->
    <depends>com.intellij.modules.java</depends>

    <idea-version since-build="181.00"/>

    <extensions defaultExtensionNs="com.intellij">
        <!-- Add your extensions here -->
    </extensions>

    <actions>

    </actions>
</idea-plugin>

plugin.xml 说明：https://jetbrains.org/intellij/sdk/docs/basics/plugin_structure/plugin_configuration_file.html

创建 Action

1. 先在 main 下创建 java 目录和包路径。

2. New -> Plugin DevKit -> Action

3. 设置 Action 的 id 、Class Name 、 description 、 group 及快捷键等。

4. 这时候会发现在 plugin.xml 也插入了 action 。

代码语言：javascript复制

<actions>
    <action id="Toolkit.Json.CopyAsJsonAction" class="com.liuzhihang.toolkit.action.CopyAsJsonAction"
            text="CopyAsJsonAction" description="Copy As Json">
        <add-to-group group-id="EditorTabsGroup" anchor="first"/>
        <keyboard-shortcut keymap="$default" first-keystroke="shift meta J"/>
    </action>
</actions>

到这里已经结构完全创建完毕了，下面将演示插件 copy-as-json 的内部逻辑。当然这块也可以直接跳过，阅读源码即可。

源码地址：见文末相关资料或关注公众号发送 copy-as-json / 3 获取。

插件效果：将 JavaBean 复制为 Json 字符串。

开发笔记

首先需要知道一些常用的 API，常用 API 可以阅读官方文档或者关注公众号后面会推送，这里仅介绍一些在这里用到的。

- 打开 CopyAsJsonAction

该类继承并需要实现 actionPerformed 方法。在 actionPerformed 方法中可以通过以下三个方法获取到项目相关信息：

代码语言：javascript复制

// 获取项目
Project project = e.getData(PlatformDataKeys.PROJECT);
// 获取Psi文件
PsiFile psiFile = e.getData(CommonDataKeys.PSI_FILE);
// 获取当前编辑的文件
Editor editor = e.getData(CommonDataKeys.EDITOR);

- 获取到当前编辑的文件

代码语言：javascript复制

@Nullable
public static PsiClass getTargetClass(@NotNull Editor editor, @NotNull PsiFile file) {
    int offset = editor.getCaretModel().getOffset();
    PsiElement element = file.findElementAt(offset);
    if (element != null) {
        // 当前类
        PsiClass target = PsiTreeUtil.getParentOfType(element, PsiClass.class);

        return target instanceof SyntheticElement ? null : target;
    }
    return null;
}

- 从当前编辑的文件里面获取到字段

将当前编辑的 JavaBean 中的字段提取，并转换为 Map。

代码语言：javascript复制

Map<String, Object> fieldsMap = getFields(selectedClass);

getFields 方法篇幅较长，请参考源码。

- 将字段转化成 Json 字符串，并格式化

使用 Gson 将 Map 转换为 Json 字符串，并格式化。其中格式化自定义了缩进。

见代码：com.liuzhihang.toolkit.utils.GsonFormatUtil

代码语言：javascript复制

Gson gson = new GsonBuilder().create();
String json = GsonFormatUtil.gsonFormat(gson, fieldsMap);

// 使用自定义缩进格式 String json = new GsonBuilder().setPrettyPrinting().create().toJson(fieldsMap);
StringSelection selection = new StringSelection(json);

- 将 Json 字符串拷贝到剪贴板

代码语言：javascript复制

StringSelection selection = new StringSelection(json);
Clipboard clipboard = Toolkit.getDefaultToolkit().getSystemClipboard();
clipboard.setContents(selection, selection);

- 发出提示 success

代码语言：javascript复制

String message = "Convert "   selectedClass.getName()   " to JSON success, copied to clipboard.";
Notification success = NOTIFICATION_GROUP.createNotification(message, NotificationType.INFORMATION);
Notifications.Bus.notify(success, project);

测试运行

右侧 Gradle -> 选择 intellij -> 点击 runlde