GMF里的contributionItemProvider扩展点的功能与org.eclipse.ui.editorActions类似，即为指定editor增加Action，但用contributionItemProvider还可以为view添加Action，以及实现添加popupMenu等多种功能，相当于eclipse提供的多种与Action有关的扩展点的集合。现以为editor增加Action为例介绍一下如何使用contributionItemProvider。

首先当然是在plugin.xml里描述contributionItemProvider扩展点的实现方式。在下面的xml代码里，首先用contributionItemProvider元素指定了实现类为com.my.MyContributionItemProvider，这个实现类可以有两种情况：一般它继承自GMF提供的AbstractContributionItemProvider；也可以直接实现IContributionItemProvider，后者情况就不需要再定义contributionItemProvider元素下的其他元素了，全部Action都可以用java代码在contributeToActionBars()和contributeToPopupMenu()方法里构造。

<extension
       point="org.eclipse.gmf.runtime.common.ui.services.action.contributionItemProviders">
    <contributionItemProvider
          checkPluginLoaded="false"
          class="com.my.MyContributionItemProvider">
       <Priority name="Low"/>
       <partContribution id="com.my.RuleDiagramEditorID">
          <partAction
                id="showConsole"
                menubarPath="/window/views">
          </partAction>
       </partContribution>
    </contributionItemProvider>
 </extension>

现在讨论继承AbstractContributionItemProvider的情况，我们需要实现createAction()方法，这个方法接受actionId作为参数。actionId参数是在plugin.xml里指定的，如上面的xml片段里，首先用partContribution元素指定要把Action添加到哪个editor上，然后用partAction元素指定希望添加的Action的id和menubarpath位置等其他参数。

实际上AbstractContributionItemProvider的主要功能就是解析contributionItemProvider下的xml元素，并根据这些元素内容调用createAction()方法，所以在createAction()方法里我们可以得到actionId并根据它创建实际的Action类。下面是对应上面xml片段的MyContributionItemProvider代码：

public class MyContributionItemProvider extends AbstractContributionItemProvider {

    @Override
    protected IAction createAction(String actionId, IWorkbenchPartDescriptor partDescriptor) {
        if (actionId.equals("showConsole")) {
            IAction action =  new ShowViewAction("&Console", "console.view.id");
            action.setImageDescriptor();
            return action;
        }
        return super.createAction(actionId, partDescriptor);
    }

    class ShowViewAction extends Action{

    }
}

最后要注意一点，如果editor和contributionItemProvider不在同一个plugin里，则一定要在plugin.xml里指定contributionItemProvider元素的checkPluginLoaded属性为false，否则这个contributionItemProvider不会被加载。（补充08/01/02: 如果menuPath设置不正确也可能导致contributionItemProvider不被加载，一个正确的menuPath是"/file/print"）

参考链接

http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg06035.html
http://dev.eclipse.org/newslists/news.eclipse.technology.gmf/msg04270.html
http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg00757.html
http://dev.eclipse.org/newslists/news.eclipse.modeling.gmf/msg08196.html

搬家前链接：https://www.cnblogs.com/bjzhanghao/archive/2007/09/17/896499.html

GMF能根据.gmftool里定义的工具项生成一个缺省的palette(在生成的XXXPaletteFactory类里实现，目前没有利用GMF扩展点)，同时GMF Runtimeh还提供了org.eclipse.gmf.runtime.diagram.ui.paletteProviders扩展点，如果缺省palette里的工具项不能满足需要，利用这个扩展点可以添加我们需要的其他工具。下图是GMF的Logic例子里对这个扩展点的实现：

图：GMF的Logic例子利用paletteProviders扩展点添加工具项

实现paletteProviders扩展点的步骤并不复杂。首先是在plugin.xml里定义扩展点需要的信息，paletteProvider的class一般选org.eclipse.gmf.runtime.diagram.ui.providers.DefaultPaletteProvider即可，它会把下面定义的信息转换为实际的工具项添加到palette里。在paletteProvider下要创建一个editor项并指定id值；还要创建contribution项包含实际需要的工具项，contribution项里需要指定一个factoryClass，这个类要自己实现，并继承自PaletteFactory.Adapter，实现它的createTool()方法，这个方法根据此contribution项下面所定义的工具的id生成实际的工具实例。下面是GMF的Logic例子所使用的paletteFactory代码，可以看到所做的工作就是根据不同的toolId返回工具实例：

public class LogicPaletteFactory
    extends PaletteFactory.Adapter {

    /*
     *  Create the tool according to type       
     */
    public Tool createTool(String toolId) {
        if (toolId.equals(LogicConstants.TOOL_LED)){
            return new CreationTool(LogicSemanticType.LED);
        }else if (toolId.equals(LogicConstants.TOOL_CIRCUIT)) {
            return new CreationTool(LogicSemanticType.CIRCUIT);
        }else if (toolId.equals(LogicConstants.TOOL_ORGATE)) {
            return new CreationTool(LogicSemanticType.ORGATE);
        }else if (toolId.equals(LogicConstants.TOOL_ANDGATE)) {
            return new CreationTool(LogicSemanticType.ANDGATE);
        }else if (toolId.equals(LogicConstants.TOOL_XORGATE)) {
            return new CreationTool(LogicSemanticType.XORGATE);
        }else if (toolId.equals(LogicConstants.TOOL_FLOWCONTAINER)) {
            return new CreationTool(LogicSemanticType.FLOWCONTAINER);

        }else if (toolId.equals(LogicConstants.TOOL_CONNECTION)) {
            return new ConnectionCreationTool(LogicSemanticType.WIRE);
        }
        return null;
    }
}

在contribution项下面可以创建多种类型的工具项(entry)，例如Drawer、Separator，Stack和Tool等等，每一个工具项除Label外需要有一个id和一个path，id的作用如刚刚提到的是给paletteFactory的createTool()方法的参数，后者根据id创建所需要的工具实例；path可以是"/"或"/entryId/"这样用来指定工具项在palette里的位置。

总结下来就是，在plugin.xml里指定各个工具项的位置，而paletteFactory负责工具id到实际工具的转换。

参考资料

Creating and Registering the Palette Provider and Factory Classes

搬家前链接：https://www.cnblogs.com/bjzhanghao/archive/2007/08/13/854514.html