AndroidStudio插件开发（进阶篇之Action机制）

这篇文章继续深入探究IntelliJ IDEA插件开发中的Action机制。一个Action本质上来说就是一个Java类，并且这个类需要继承AnAction。而一个Action对应于一个菜单项，每一次点击这个菜单项就回调这个Action的actionPerformed(AnActionEvent event)函数，因此我们定义的Action在继承AnAction时，需要重写actionPerformed函数。定义好Action类后，我们需要注册Action，即在plugin.xml文件中添加Action对应的标签，在这个标签中定义了Action应放置在界面的的哪个位置，作为哪个菜单项的子项等。接下来我们对Action机制进行深入。

1. 定义Action（继承AnAction）

定义Action只需简单地定义一个继承AnAction的子类即可，子类中，最重要的就是actionPerformed函数和update函数。

1.1 重写actionPerformed函数

我们知道，每次在菜单项中点击我们自定义的Action时，对应会执行AnAction的actionPerformed函数。对应actionPerformed函数的理解，只需记住，当回调actionPerformed函数函数时，就意味着当前Action被点击了一次。重写actionPerformed函数非常简单，这里简单弹出一个Hello World。

package com.huachao.plugin;

import com.intellij.openapi.actionSystem.AnAction;
import com.intellij.openapi.actionSystem.AnActionEvent;
import com.intellij.openapi.actionSystem.PlatformDataKeys;
import com.intellij.openapi.project.Project;
import com.intellij.openapi.ui.Messages;

/**
 * Created by huachao on 2016/12/26.
 */
public class MyAction extends AnAction {
    @Override
    public void actionPerformed(AnActionEvent event) {
        Project project = event.getData(PlatformDataKeys.PROJECT);
        Messages.showMessageDialog(project, "Hello World!", "Information", Messages.getInformationIcon());
    }
}

1.2 重写update函数

我们知道，为了响应用户的点击操作，我们重写了actionPerformed函数。在actionPerformed函数中执行一些逻辑，比如弹出对话框，在打开文件中自动生成代码等等操作。这些逻辑在actionPerformed函数中完成就好，但是，有时候我们定义的插件只在某些场景中使用。比如说，当我们编写自动生成代码的插件时，只有当有文件打开时才可以正常执行。因此，当我们不希望用户点击我们定义的插件时，我们可以将插件隐藏，让用户无法看到插件，只有当符合插件执行的环境时，才让插件在菜单中显示。

为了能在用户点击自定义插件对应的菜单项之前动态判断是否将插件项显示，只需重写update函数。

update函数在Action状态发生更新时被回调，当Action状态刷新时，update函数被IDEA回调，并且传递AnActionEvent对象，AnAction对象中封装了当前Action对应的环境。

如何理解上面这段话呢？我们知道，我们定义的每个Action都在菜单中对应一个子选项（为了方便描述，本文称之为Action菜单项），当Action菜单项被点击或者是Action的父菜单（包含Action菜单项的菜单）被点击使得Action菜单项被显示出来时，就会回调update函数。在update被回调时，传入AnActionEvent对象，通过AnActionEvent对象我们可以判断当前编辑框是否已经打开等实时IDEA环境状况。

注意：先执行update函数，再执行actionPerformed函数。换言之，update发生在actionPerformed之前。

比如，我们想要实现：当编辑框被打开时显示自定义的Action菜单项，否则，将Action菜单项设置为灰色。

@Override
public void update(AnActionEvent e) {
    Editor editor = e.getData(PlatformDataKeys.EDITOR);

    if (editor != null)
        e.getPresentation().setEnabled(true);
    else
        e.getPresentation().setEnabled(false);

}

代码中，如果editor!=null即编辑框已打开，将Action菜单项设置为可用状态（即正常颜色，黑色），否则设置为不可用状态（即灰色）。当然了，你也可以通过e.getPresentation().setVisible(false);将Action菜单项设置为不可见，这样Action菜单项就不会出现在菜单中。

当编辑框被打开时（即有文件打开时），可以看到我们自定义的插件是正常。

当编辑框被关闭时（即没有文件被打开时），可以看到我们自定义的插件是灰色。

注意：Action菜单项为灰色并不意味着被点击时actionPerformed不会被调用，相反，只要Action菜单项被点击，actionPerformed函数就会被调用。因此如果希望点击Action菜单项时不做响应，需要在actionPerformed函数里面再次做具体判断。