菜单是各种软件及开发平台会提供的必备功能，Eclipse 也不例外，提供了丰富的菜单，包括主菜单（Main Menu），视图 / 编辑器菜单（ViewPart/Editor Menu）和上下文菜单（Context Menu）。在 Eclipse 中，几乎所有的 Workbench Part 提供了人性化的菜单，大大方便了用户的操作。因此，如何扩展 Eclipse 的菜单功能，并实现特定于我们自己插件的菜单，是插件开发者必须掌握的重要技能，同时，Eclipse 提供了丰富的扩展点供开发人员使用。本文将首先介绍 Eclipse 中的菜单，然后详细说明如何进行扩展，最后以一个实例的形式引导读者深入理解 Eclipse 的菜单功能。

　　引言

　　Eclipse 具有丰富的菜单功能，给开发人员提供了很好的用户体验。总体而言，Eclipse 菜单种类包括视图 / 编辑器菜单，主菜单（Main Menu），视图 / 编辑器菜单（ViewPart/EditorPart Menu）和上下文菜单（Context Menu）。插件开发人员通过灵活应用这些菜单，可以给用户提供很好的体验。由于视图和编辑器菜单功能类似，因此本文重点讲述视图菜单（视图下拉菜单及其工具栏菜单），除此之外，还将讲述主菜单和上下文菜单。

　　如图 1 所示为 Project Explorer 视图的菜单，包括视图下拉菜单和工具栏菜单（折叠树节点）。通常而言，出现在视图工具栏的菜单都会出现在视图的下拉菜单，也就是说，比较常用的视图菜单放在视图的工具栏。

图 1. Project Explorer 视图的菜单

　　如图 2 所示为 Project Explorer 视图中的上下文菜单，只有当我们右键点击时才会出现。通常而言，出现频率较高的菜单项才会出现在菜单中。上下文菜单具有很强的灵活项，它可以随着我们点击的对象不同，弹出的菜单也会有相应的变化。

图 2. Project Explorer 视图中的上下文菜单

　　如图 3 所示为 Eclipse 的主菜单，包括最上面的主菜单项（不可移动）及其下面的工具栏菜单（可以移动，并且 Eclipse 提供了显示 / 不显示这些菜单的功能），Eclipse 并不建议我们为每一个插件都添加新的主菜单，这样容易造成冗余，而且不方便用户操作。通常，我们可以把菜单项添加到 Eclipse 已有的菜单，如插件的查找功能可以添加一个查找菜单项到 Eclipse 的 Search 主菜单上。

图 3. Eclipse 的主菜单

　　前面讲到 Eclipse 的各种菜单，那么，如何在开发插件或 RCP 应用程序的时候添加这些菜单？本文下面的篇幅将详细介绍如何扩展 Eclipse 的菜单功能，使读者深入了解 Eclipse 的菜单功能，并能够开发具有这些菜单的应用程序。因此，必须掌握三方面的内容：菜单种类，菜单的扩展点，菜单控制（显示 / 隐藏或启用 / 禁用菜单项）。下面从概念上介绍这三方面内容，下一小节将会进行详细介绍。

　　菜单种类

　　正如前面所讲到的，Eclipse 的菜单包括视图菜单，主菜单及上下文菜单三个种类。

　　菜单项的扩展点

　　Eclipse 提供了两种扩展点供用户添加菜单项到相应的位置。这两种扩展点为 org.eclipse.ui.commands（本文简称为 Commands 方式）和 org.eclipse.ui.actionSets（本文简称为 Actions 方式）。Actions 方式为界面上不同区域的表现方式提供了相应的扩展点，并且没有分离其界面表现和内在实现。恰恰相反，Commands 方式通过三步有效的达到界面表现和内部实现的分离：首先，通过 org.eclipse.ui.commands 扩展点创建命令和类别（Category），并且可以把某些命令放在一个类别（Category）中；然后，通过 org.eclipse.ui.menus 指定命令出现在界面的哪个区域（视图菜单 / 主菜单 / 上下文菜单）；最后通过 org.eclipse.ui.handlers 指定命令的实现。因此，Eclipse 推荐新开发的插件使用 Commands 来创建您的界面菜单。当然，由于 Actions 在现有的插件中用得比较多，如果我们需要扩展或基于之前的插件开发，也需要对其进行了解。除此之外，针对上下文菜单，虽然 Commands 和 Actions 方式均可以创建上下文菜单，但是 Eclipse 还提供了另外一种创建上下文菜单的扩展点 org.eclipse.ui.popupMenus（本文简称为 popupMenus 方式），本文将就这三种扩展点做详细的介绍。

　　菜单控制

　　菜单控制是一个非常常见的功能，例如，随着选定的内容或当前窗口的不同，菜单中的菜单项会有相应的变化（显示 / 隐藏或启用 / 禁用菜单项），因此，如何控制菜单是插件开发人员必须掌握的知识。Eclipse 为菜单控制提供了两种方法，一种是通过扩展点；另一种是通过 API 的方式编写程序控制。

　　Eclipse 菜单功能及其扩展点

　　至此，我们对 Eclipse 菜单有了感观的认识。由上一节我们可知，要深入理解 Eclipse 菜单功能，我们需要从三个方面去掌握：菜单种类，菜单的扩展点和菜单控制。下面将进行详细讲述。

　　菜单种类

　　针对各种菜单，Eclipse 提供了相应的扩展点，因此，开发人员可以通过这些扩展点把菜单放到界面的不同区域，详细内容请参考 2.2 小节。

　　菜单的扩展点

　　视图菜单的扩展点

　　采用 Commands 方式创建视图菜单，需要引入 org.eclipse.ui.menus 扩展点；而 Actions 方式需要引入 org.eclipse.ui.actionSets.

　　1、视图菜单（Commands 方式）：

　　MenuContribution locationURI = “[Scheme]:[id]?[argument-list]”

　　其中，Scheme 为该菜单项出现的区域，menu 为视图的下拉菜单，toolbar 为视图的工具栏菜单；id 为菜单区域 ID；argument-list 为该菜单项出现在指定菜单的位置。

　　例如：在 ProbelmView 的下拉菜单加一个菜单项，其 MenuContribution 的 locationURI 应为：menu:org.eclipse.ui.views.ProblemView?after=additions；在 ProblemView 的工具栏菜单中加入一个菜单项，其 locationURI 应为：toolbar:org.eclipse.ui.views.ProblemView?after=additions。

　　2、视图菜单（Actions 方式）：

　　采用 Actions 方式创建菜单，需要引入 org.eclipse.ui.actionSets 扩展点，并通过设定 action 的 menubarPath 指定下拉菜单 / 菜单项出现的位置；通过设定 action 的 toolbarPath 设定工具栏菜单 / 菜单项出现的位置。

　　例如，添加一个下拉菜单项到 Problems 视图中，其 menubarPath 应为：

　　org.eclipse.ui.views.ProblemView/additions

　　主菜单的扩展点

　　1、主菜单（Commands 方式）

　　通过 Commands 方式把菜单项添加到主菜单及其工具栏上，和视图菜单一样，也是通过扩展点 org.eclipse.ui.menus 实现，需要设定其 menuContribution 的 locationURI。

　　例如，添加一个菜单（菜单可以包含若干个菜单项）到主菜单一栏中，其 locationURI 为：

　　menu:org.eclipse.ui.main.menu?after=additions

　　添加一个菜单到工具栏之中，其 locationURI 为：

　　toolbar:org.eclipse.ui.main.toolbar?after=additions

　　当然，我们也可以把菜单项添加到已经存在的菜单当中，例如添加一个菜单项到 Eclipse 的 Search 主菜单当中，其 locationURI 为：

　　menu:org.eclipse.search.menu?dialogGroup

　　2、主菜单（Actions 方式）

　　通过 Actions 方式把菜单项添加到主菜单及其工具栏上，和视图菜单一样，也是通过扩展点 org.eclipse.ui.actionSets 实现，需要设定 action 的 menubarPath 和 toolbarPath 实现。

　　例如，添加一个菜单项到 Eclipse 的 Search 主菜单中，其 menubarPath 应为：

　　org.eclipse.search.menu/dialogGroup

　　注意：如果采用上述方式添加一个菜单项到 Search 主菜单，当我们运行时并没有出现添加的菜单项，这时候需要换一个 workspace，其原因是 Eclipse 缓存了与其相关的某些信息在 workspace 当中。

　　上下文菜单的扩展点

　　上下文菜单除了通过 Commands 和 Actions 方式添加，还可以使用扩展点 org.eclipse.ui.popupMenus 方式添加，下面分别进行介绍。

　　1、上下文菜单（Commands 方式）

　　Commands 方式与添加视图菜单和主菜单的方式一样，通过设定其 menuContribution 的 locationURI 来实现。

　　例如，添加一个上下文菜单到 Problems 视图中，其 locationURI 为：

　　popup:org.eclipse.ui.views.ProblemView?after=additions。

　　如果我们想让某个上下文菜单项出现在任何区域，则可以使用下面的 locationURI：

　　popup:org.eclipse.ui.popup.any?after=additions

　　2、上下文菜单（Actions 方式）

　　Actions 方式没有直接提供扩展点添加上下文菜单，但是我们可以通过编程的方式实现，如下代码清单 1 为 TreeViewer 添加上下文菜单，通过 IMenuManager 的 add 方法添加 actions。

清单 1. 通过 Actions 方式编程实现添加上下文菜单

　private　void　hookContextMenu()　{　
　　IMenuManager　fMenuMgr　=　new　MenuManager(“#PopupMenu”);　
　　fMenuMgr.setRemoveAllWhenShown(true);　
　　//　添加　Actions　
　　fMenuMgr.add(action　…　)　
　　fMenuMgr.createContextMenu(treeViewer.getControl());　
　　treeViewer.getControl().setMenu(fMenu);　
　　getSite().registerContextMenu(fMenuMgr,　treeViewer);　
　}　

　　3、上下文菜单（popupMenus 方式）

　　通过 popupMenus 扩展点实现上下文菜单，需要设定 objectContribution 的 objectClass 属性把上下文菜单添加到相应的区域。

　　例如，如果我们想当用户点击 Eclipse 中的资源时，弹出的上下文菜单包括某个菜单项，我们可以设定 objectClass 属性为：

　　org.eclipse.core.resources.IResource

　　通过 Commands 方式创建菜单项

　　通过 Commands 方式创建菜单项，首先需要创建 Command，通过扩展点 org.eclipse.ui.commands，然后我们可以把这个 Command 放到任何区域，上一小节已经讲到，通过 org.eclipse.ui.menus 扩展点确定菜单创建的区域，最后通过扩展点 org.eclipse.ui.handlers 定义这个 command 的具体行为。

　　在创建 Command 时，我们可以先创建一个 Category，并把相关的一些命令放到这个 Category 中，这样有利于管理。代码清单 2 创建一个 Command(“Show in Glossary Explorer”)，并放到一个 Category 中，然后把该 Command 放到 BGSearchResultView 视图的上下文菜单中，最后通过扩展 org.eclipse.ui.handlers 定义该 Command 的实现类。

清单 2. 通过 Commands 方式添加菜单项

　<!--　添加　command　-->　
　<extension　
　　　point="org.eclipse.ui.commands">　
　　<category　
　　　description="Business　Glossary"　
　　　id="com.ibm.bg.ui.commands.category"　
　　　name="%category.BusinessGlossary.name">　
　　</category>　
　　<command　
　　　categoryId="com.ibm.bg.ui.commands.category"　
　　　description="Show　in　Glossary　Explorer"　
　　　id="com.ibm.bg.ui.commands.BGShowInBrowser"　
　　　name="%command.ShowInGE.name">　
　　</command>　
　</extension>　
　<!--　把　Command　放到界面的对应区域　-->　
　<extension　
　　　　point="org.eclipse.ui.menus">　
　　<menuContribution　locationURI=　
　　"popup:com.ibm.bg.internal.ui.search.BGSearchResultView?after=additions">　
　　　<command　
　　　　　　commandId="com.ibm.bg.ui.commands.BGShowInBrowser"　
　　　　　　style="push"　
　　　　　　tooltip="%command.ShowInGE.tooltip">　
　　　</command>　
　　</menuContribution>　
　</extension>　
　<!--　定义　command　的实现类　-->　
　<extension　
　　　point="org.eclipse.ui.handlers">　
　　<handler　
　　　　　class="com.ibm.bg.internal.ui.handlers.BGShowInBrowser"　
　　　　　commandId="com.ibm.bg.ui.commands.BGShowInBrowser">　
　　</handler>　
　</extension>　

　　通过 Actions 方式创建菜单项

　　正如前面讲到，Actions 方式没有分离界面的表现和内部实现，因此，所有这些均通过 action 来完成。如下代码清单 3 为添加一个 Search 菜单项到 Eclipse 的 Search 主菜单（通过 action 的 menubarPath 指定）中，其中 class 对应的值为该 Action 的实现类，该类需要实现接口 IWorkbenchWindowActionDelegate。

清单 3. 通过 Actions 方式添加菜单项

　<extension　
　　　point="org.eclipse.ui.actionSets">　
　　<actionSet　
　　　　　id="com.ibm.bg.ui.workbenchActionSet"　
　　　　　label="%category.name.0"　
　　　　　visible="true">　
　　　<action　
　　　　　　class="com.ibm.bg.internal.ui.handlers.BGSearchHandler"　
　　　　　　definitionId="com.ibm.bg.ui.commands.BGSearch"　
　　　　　　icon="icons/search.png"　
　　　　　　id="com.ibm.bg.ui.commands.BGSearch"　
　　　　　　label="%action.searchGlossayInMainMenu.label"　
　　　　　　menubarPath="org.eclipse.search.menu/dialogGroup"　
　　　　　　style="push">　
　　　</action>　
　　</actionSet>　
　</extension>　

　　通过 popupMenus 方式创建菜单项

　　popupMenus 方式创建上下文菜单项也是通过 action 来实现，下面例子为添加一个菜单项到用户右击 IGraphicalEditPart 对象时弹出的上下文菜单，通过 menubarPath 指定该 Action 出现的区域，通过 class 指定该 action 的实现类，该类需要实现接口 IObjectActionDelegate。

清单 4. 通过 popupMenus 方式添加菜单项

　<extension　
　　　point="org.eclipse.ui.popupMenus">　
　　<objectContribution　
　　　　　adaptable="false"　
　　　　　id="com.ibm.bg.uml.objectContributions.BGAssignToGlossary"　
　　　　　objectClass="org.eclipse.gmf.runtime.diagram.ui.editparts.IGraphicalEditPart">　
　　　<action　
　　　　　　class="com.ibm.bg.internal.uml.actions.BGAssignToGlossary"　
　　　　　　enablesFor="+"　
　　　　　　icon="icons/assign.png"　
　　　　　　id="com.ibm.bg.internal.uml.actions.BGAssignToGlossary"　
　　　　　　label="%BGAssignToGlossary.item"　
　　　　　　menubarPath="com.ibm.bg.uml.popupMenuGroup">　
　　　</action>　
　　</objectContribution>　
　</extension>　

　　菜单控制

　　视图菜单的控制主要包括启用 / 禁用，显示 / 隐藏菜单。

　　通过 Command 方式创建的菜单，可以通过 org.eclipse.ui.commands 的 visibleWhen 属性控制菜单的隐藏和显示，通过 org.eclipse.ui.handlers 的 activewhen 或 enabledWhen 控制菜单的启用或禁用。

　　通过 Actions 方式创建的菜单，可以通过 action 的 enablement 属性控制菜单的启用 / 禁用。

　　通过 popupMenus 方式创建的菜单，可以通过 objectContribution 的 visibility 和 enablement 来设置该 objectContribution 下的 action 的显示 / 隐藏和启用 / 禁用，我们也可以设置 action 的 enablement 来控制该菜单的启用 / 禁用。

　　这里不详细讲述 enablement，visibleWhen 和 enabledWhen 的参数及如何设置，读者可以参考第三节的例子和本文的参考文献。

　　编程实践

　　本文将结合前两节讲到的知识，以例子的形式说明如何创建并且控制菜单。首先创建一个视图（Menu Example），然后分别通过 Commands，Actions 和 popupMenus 方式创建若干个菜单，并添加相应的菜单控制点。

　　创建 Menu Example 视图

　　扩展 org.eclipse.views 创建“Menu Example”视图，如下代码清单 5 为创建视图的 xml 代码。

清单 5. 扩展 org.eclipse.ui.views 创建视图

　<extension　
　　　point="org.eclipse.ui.views">　
　　<category　
　　　　　id="com.free.menu.category"　
　　　　　name="Menu　Example　View">　
　　</category>　
　　<view　
　　　　　category="com.free.menu.category"　
　　　　　class="com.free.menu.view.MenuExplorer"　
　　　　　id="com.free.menu.view.MenuExplorer"　
　　　　　name="Menu　Explorer"　
　　　　　restorable="true">　
　　</view>　
　</extension>　

　　创建 Commands

　　采用 Command 方式创建“Menu Example”主菜单（包含 AngryCommand 和 JokeCommand 两个菜单项），并且基于这两个菜单项创建了 Menu Example 视图的下拉菜单和工具栏菜单，及其 TreeViewer 的上下文菜单。

　　如下代码清单 6 为扩展 org.eclipse.ui.commands 创建 Menu Example 命令和类别，并且包含两个命令：Joke Command 和 Angry Command。

清单 6. 扩展 org.eclipse.ui.commands 创建命令

　<extension　
　　　point="org.eclipse.ui.commands">　
　　<category　
　　　　　id="com.free.menu.category"　
　　　　　name="Menu　Example">　
　　</category>　
　　<command　
　　　　　categoryId="com.free.menu.category"　
　　　　　id="com.free.menu.commands.jokeCommand"　
　　　　　name="Joke　Command">　
　　</command>　
　　<command　
　　　　　categoryId="com.free.menu.category"　
　　　　　id="com.free.menu.commands.angryCommand"　
　　　　　name="Angry　Command">　
　　</command>　
　</extension>　

　　关联 Commands 到主菜单

　　如下代码清单 7 为扩展 org.eclipse.ui.menus，并基于前面创建的 Comands，添加一个主菜单 Menu Example，并且包含 Joke Command 和 Angry Command 菜单项。

清单 7. 创建 Menu Example 主菜单

　<menuContribution　
　　　locationURI="menu:org.eclipse.ui.main.menu?after=additions">　
　　<menu　
　　　id="com.free.menu.MenuExample"　
　　　　　label="Menu　Example">　
　　　<command　
　　　　　　commandId="com.free.menu.commands.jokeCommand"　
　　　　　　style="push">　
　　　</command>　
　　　<command　
　　　　　　commandId="com.free.menu.commands.angryCommand"　
　　　　　　style="push">　
　　　</command>　
　　</menu>　
　</menuContribution>　

　　Commands 的实现类

　　如下代码清单 9 所示扩展 org.eclipse.ui.handlers 为 Joke Command 和 Angry Command 创建事件处理类，其中 Joke Command 通过 enabledWhen 属性控制该菜单项是否启用，当我们同时选择了两个对象时 Joke Command 处于启用状态，否则为禁用。

清单 9. 扩展 org.eclipse.ui.handlers 为 Commands 创建实现类

　<extension　
　　　point="org.eclipse.ui.handlers">　
　　<handler　
　　　　　class="com.free.menu.actions.JokeCommand"　
　　　　　commandId="com.free.menu.commands.jokeCommand">　
　　　<enabledWhen>　
　　　　　<count　
　　　　　　　　value="2">　
　　　　　</count>　
　　　</enabledWhen>　
　　</handler>　
　　<handler　
　　　　　class="com.free.menu.actions.AngryCommand"　
　　　　　commandId="com.free.menu.commands.angryCommand">　
　　</handler>　
　</extension>　

　　创建 Action 并关联到 Eclipse 的 Search 主菜单

　　采用 Actions 方式在 Eclipse 的主菜单 Search 中添加创建菜单项 SmileAction。扩展 org.eclipse.ui.actionSets 在 Eclipse 的主菜单 Search 中添加一个菜单项 Smile Action。如下代码清单 10 所示创建该 action 并添加到 search 主菜单，只有当我们选择至少一个对象时（设置 enablesFor 属性为“+”），该菜单项才处于启用状态。

清单 10. 通过 Actions 方式创建菜单项

　<extension　
　　　point="org.eclipse.ui.actionSets">　
　　<actionSet　
　　　　　id="com.free.menu.actionSet.MenuExample"　
　　　　　label="Menu　Example"　
　　　　　visible="true">　
　　　<action　
　　　　　　class="com.free.menu.actions.SmileAction"　
　　　　　　enablesFor="+"　
　　　　　　icon="icons/searchres.gif"　
　　　　　　id="com.free.menu.actions.smileAction"　
　　　　　　label="Smile　Action"　
　　　　　　menubarPath="org.eclipse.search.menu/dialogGroup"　
　　　　　　style="push">　
　　　</action>　
　　</actionSet>　
　</extension>　

　　pupupMenus 方式创建 Action 并关联到 IResource 资源的上下文菜单

　　扩展 org.eclipse.ui.popupMenus 创建菜单“Menu Example”，该菜单包含一个菜单项 HelloAction。当我们在 Eclipse 任何区域右击 org.eclipse.core.resources.IResource 资源时弹出的上下文菜单中会出现“Menu Example”菜单。如下代码清单 11 为创建该上下文菜单的 xml 代码。

清单 11. popupMenus 方式创建上下文菜单

　<extension　
　　　point="org.eclipse.ui.popupMenus">　
　　<objectContribution　
　　　　　adaptable="true"　
　　　　　id="com.free.menu.popupMenu"　
　　　　　objectClass="org.eclipse.core.resources.IResource">　
　　　<menu　
　　　　　　label="Menu　Example"　
　　　　　　path="additions"　
　　　　　　id="com.free.menu.popupSubMenu">　
　　　　　<separator　
　　　　　　　　name="additions">　
　　　　　</separator>　
　　　</menu>　
　　　<action　
　　　　　　label="Hello　Action"　
　　　　　　class="com.free.menu.popup.actions.HelloAction"　
　　　　　　menubarPath="com.free.menu.popupSubMenu/additions"　
　　　　　　enablesFor="1"　
　　　　　　id="com.free.menu.newAction">　
　　　</action>　
　　</objectContribution>　
　</extension>　

　　pupupMenus 方式创建 Action 并关联到 IResource 资源的上下文菜单

　　扩展 org.eclipse.ui.popupMenus 创建菜单项 GreetAction 和 CryAction，当我们右击 Menu Example 视图中的 TreeViewer 节点时弹出。如下代码清单 12 所示扩展 org.eclipse.ui.popupMenus 为 Menu Example 视图创建 GreetAction 和 CryAction 上下文菜单项。使用 visiblity 的 objectState 属性控制菜单项的可见状态，使用该属性要求其选择的对象实现了 org.eclipse.ui.IActionFilter 接口，具体可参见 Person 类的实现。

清单 12. 扩展 org.eclipse.ui.popupMenus 创建菜单

　<extension　
　　　point="org.eclipse.ui.popupMenus">　
　　<objectContribution　
　　　　　adaptable="false"　
　　　　　id="com.free.menu.views.popupMenu"　
　　　　　objectClass="com.free.menu.model.Person">　
　　　<action　
　　　　　　class="com.free.menu.actions.GreetAction"　
　　　　　　enablesFor="+"　
　　　　　　id="com.free.menu.actions.greetAction"　
　　　　　　label="Greet　Action"　
　　　　　　menubarPath="additions">　
　　　</action>　
　　　<visibility>　
　　　　　<objectState　
　　　　　　　　name="firstName"　
　　　　　　　　value="Dan">　
　　　　　</objectState>　
　　　</visibility>　
　　</objectContribution>　
　</extension>　
　<extension　
　　　point="org.eclipse.ui.popupMenus">　
　　<objectContribution　
　　　　　adaptable="false"　
　　　　　id="com.free.menu.views.popupMenu2"　
　　　　　objectClass="com.free.menu.model.Person">　
　　　<action　
　　　　　　class="com.free.menu.actions.CryAction"　
　　　　　　enablesFor="+"　
　　　　　　id="com.free.menu.actions.cryAction"　
　　　　　　label="Cry　Action"　
　　　　　　menubarPath="additions">　
　　　　　<enablement>　
　　　　　　<objectState　
　　　　　　　　　name="firstName"　
　　　　　　　　　value="David">　
　　　　　　</objectState>　
　　　　　</enablement>　
　　　</action>　
　　　<visibility>　
　　　　　<objectState　
　　　　　　　　name="lastName"　
　　　　　　　　value="Rubel">　
　　　　</objectState>　
　　　</visibility>　
　　</objectContribution>　
　</extension>　

　　Menu Example 视图的代码实现类

　　如下代码清单 13 所示为 Menu Example 视图的代码，该视图中有一个 TreeViewer，并通过函数 hookContextMenu 把上下文菜单关联到 TreeViewer。其中函数 viewMenuAction 用于更新菜单的状态，它首先获取视图菜单，然后调用 IMenuManager 的 update 方法更新对应菜单项的状态，从而达到控制菜单的目的。

清单 13. Menu Example 视图代码

　public　class　MenuExplorer　extends　ViewPart　{　
　　private　TreeViewer　treeViewer;　
　　private　MenuManager　fMenuMgr;　
　　private　Menu　fMenu;　
　　private　static　MenuExplorer　fInstance　=　null;　
　　public　MenuExplorer()　{　
　　　　fInstance　=　this;　
　　}　
　　public　static　MenuExplorer　getInstance(){　
　　　　return　fInstance;　
　　}　
　　public　void　createPartControl(Composite　parent)　{　
　　　　treeViewer　=　new　TreeViewer　(parent,　SWT.MULTI);　
　　　　treeViewer.setLabelProvider(new　PersonListLabelProvider());　
　　　　treeViewer.setContentProvider(new　PersonTreeContentProvider());　
　　　　treeViewer.setInput(Person.example());　
　　　　this.getSite().setSelectionProvider(treeViewer);　
　　　　hookContextMenu();　
　　　　fInstance　=　this;　
　　　　　
　　}　
　　public　void　setViewMenuActionState(boolean　state){　　　　　
　　　　JokeCommand.setState(state);　
　　　　viewMenuAction();　
　　}　
　　private　void　viewMenuAction()　{　
　　　　IActionBars　bars=　getViewSite().getActionBars();　
　　　　final　IMenuManager　menu=　bars.getMenuManager();　　　
　　　　　
　　　　UIOperation.asyncExecCommand(new　Runnable(){　
　　　　　　public　void　run()　{　
　　　　　　　　menu.update("com.free.menu.commands.jokeAction");　
　　　　　　}　　　　　　　
　　　　});　　　　　
　　}　
　　private　void　hookContextMenu()　{　
　　　　fMenuMgr　=　new　MenuManager("#PopupMenu");　
　　　　fMenuMgr.setRemoveAllWhenShown(true);　
　　　　fMenuMgr.addMenuListener(new　IMenuListener()　{　
　　　　　　public　void　menuAboutToShow(IMenuManager　manager)　{　　　　　　　　　
　　　　　　}　
　　　　});　
　　　　fMenu　=　fMenuMgr.createContextMenu(treeViewer.getControl());　
　
　　　　treeViewer.getControl().setMenu(fMenu);　
　　　　getSite().registerContextMenu(fMenuMgr,　treeViewer);　　　　　　　　
　　}　　　
　　public　void　setFocus()　{　
　　　　treeViewer.getTree().setFocus();　
　
　　}　
　}　

　　Person 类的实现

　　如下代码清单 14 为 Person 类的实现，用于表示 MenuExample 视图中 TreeViewer 的一个节点，它实现了 IActionFilter 接口，通过 testAttribute 来确定是否显示 / 隐藏菜单（其中 target 表示用户选择的对象，name/value 对应于 plugin.xml 文件中 objectState 的 name/value）.

清单 14. Person 类实现

　public　class　Person　implements　IActionFilter　{　
　
　　private　String　firstName　=　"John";　
　　private　String　lastName　=　"Doe";　
　　protected　int　age　=　37;　
　　public　Person[]　children　=　new　Person[0];　
　　public　Person　parent　=　null;　
　　public　Person(String　firstName,　String　lastName,　int　age)　{　
　　　　this.firstName　=　firstName;　
　　　　this.lastName　=　lastName;　
　　　　this.age　=　age;　
　　}　
　　public　Person(String　firstName,　String　lastName,　int　age,　Person[]　children)　{　
　　　　this(firstName,　lastName,　age);　
　　　　this.children　=　children;　
　　　　for　(int　i　=　0;　i　<　children.length;　i++)　{　
　　　　　　children[i].parent　=　this;　
　　　　}　
　　}　
　　public　String　getFirstName()　{　
　　　　return　this.firstName;　
　　}　
　　public　String　getLastName()　{　
　　　　return　this.lastName;　
　　}　
　　public　static　Person[]　example()　{　
　　　　return　new　Person[]　{　
　　　　　　　　new　Person("Dan",　"Rubel",　38,　new　Person[]　{　
　　　　　　　　　　　　new　Person("Beth",　"Rubel",　8),　
　　　　　　　　　　　　new　Person("David",　"Rubel",　3)　}),　
　　　　　　　　new　Person("Eric",　"Clayberg",　39,　new　Person[]　{　
　　　　　　　　　　　　new　Person("Lauren",　"Clayberg",　6),　
　　　　　　　　　　　　new　Person("Lee",　"Clayberg",　4)　}),　
　　　　　　　　new　Person("Mike",　"Taylor",　52)　};　
　　}　
　　public　String　toString()　{　
　　　　return　firstName　+　"　"　+　lastName;　
　　}　
　　public　boolean　testAttribute(Object　target,　String　name,　String　value)　{　
　
　　　　if　(target　instanceof　Person)　{　
　　　　　　Person　person　=　(Person)　target;　
　　　　　　if　(name.equals("firstName")　&&　value.equals(person.getFirstName()))　{　
　　　　　　　　return　true;　
　　　　　　}　
　
　　　　　　if　(name.equals("lastName")　&&　value.equals(person.getLastName()))　{　
　　　　　　　　return　true;　
　　　　　　}　
　　　　}　
　　　　return　false;　
　　}　
　}　

　　总结

　　至此为止，已经把 Eclipse 菜单功能及其扩展点涉及到的类 / 接口 /API 进行了详细的说明，相信读者已经有清晰的认识了。对于前面提到 popupMenus 方式创建上下文菜单，要求选择的对象实现 IActionFilter 接口，但是，如果开发人员正在使用 gmf 进行开发，那么我们可以不必要求选择的对象实现 IActionFilter，我们可以通过扩展 org.eclipse.gmf.runtime.common.ui.services.action.actionFilterProviders 对菜单项进行控制，如下代码清单 15 为扩展该 extension point 的 xml 代码，我们可以定义多个属性（<Attribute> … </Attribute），其中 Attribute 的 name 和 value 对应于 visibility 的 objectState 中的 name 和 value。

清单 15. 通过 actionFilterProviders 扩展点实现对菜单的控制

　<extension　
　point="org.eclipse.gmf.runtime.common.ui.services.action.actionFilterProviders">　
　　　<ActionFilterProvider　
　　　　　　class="com.free.menu.PopupActionFilterProvider">　
　　　　<Priority　
　　　　　　　name="Medium">　
　　　　</Priority>　
　　　　<Attribute　
　　　　　　　name="com.ibm.bg.uml.search.isSupportedType"　
　　　　　　　value="supported">　
　　　　</Attribute>　
　　　</ActionFilterProvider>　
　</extension>　

　　如下代码清单 16 所示 PopupActionFilterProvider 的实现，它继承 AbstractActionFilterProvider，只需要实现其中的 testAttribute 和 provides 方法，当 testAttribute 返回 true 时，那么该菜单项被启用，否则禁用。其中 target 对应于我们选择的对象，name 和 value 参数对应于 visiblity 中 objectState 的 name 和 value 的指定值 ( 与前面提到的 Person 类中的 testAttribute 方法类似 )。

清单 16. actionFilterProviders 扩展点实现类

　public　class　PopupActionFilterProvider　extends　AbstractActionFilterProvider　{　
　
　
　　public　PopupActionFilterProvider()　{　
　　}　
　
　　public　boolean　testAttribute(Object　target,　String　name,　String　value)　{　
　　　　　　　
　　}　
　
　　public　boolean　provides(IOperation　operation)　{　
　　　　return　false;　
　　}　
　
　}

MyEclipse has detected that less than 5% of the 64MB of Perm
Gen (Non-heap memory) space remains. It is strongly recommended
that you exit and restart MyEclipse with new virtual machine memory
paramters to increase this memory.   Failure to do so can result in
data loss. The recommended Eclipse memory parameters are:
eclipse.exe -vmargs -Xms128M -Xmx512M -XX:PermSize=64M -XX:MaxPermSize=128M

eclipse根目录下面的 eclipse.ini 配置 从网上搜了些资料

-vmargs：说明后面是VM的参数
-Xms128m：虚拟机占用系统的最小内存
-Xmx512m：虚拟机占用系统的最大内存的5%为25.6M，理论上要求-Xmx的数值与-XX:MaxPermSize必须大于25.6M
-XX:PermSize：最小堆大小。一般报内存不足时,都是说这个太小, 堆空间剩余小于5%就会警告,建议把这个稍微设大一点,不过要视自己机器内存大小来设置
-XX:MaxPermSize：最大堆大小。这个也适当大些

把里面的参数改为
-vmargs  
-Xms128M  
-Xmx512M  
-XX:PermSize=128M  
-XX:MaxPermSize=256M
问题解决！

从网上的资料看PermSize大一点肯定更好，而且最好是设置PermSize和MaxPermSize一样大。理由如下：
PermSize 和MaxPermSize如果设置为相同还可以在一定程度上提高性能，因为，PermSize在不断的变化中会需要转移其中的数据。如果固定了以后，则可以减少每次扩大PermSize带来的性能损失。

1、PermGen space简介
　　
　　PermGen space的全称是Permanent Generation space，是指内存的永久保存区域OutOfMemoryError: PermGen space从表面上看就是内存益出，解决方法也一定是加大内存。
　　
　　说说为什么会内存益出：
　　（1）这一部分用于存放Class和Meta的信息，Class在被 Load的时候被放入PermGen space区域，它和和存放Instance的Heap区域不同。
　　（2） GC(Garbage Collection)不会在主程序运行期对PermGen space进行清理，所以如果你的APP会LOAD很多CLASS 的话,就很可能出现PermGen space错误。这种错误常见在web服务器对JSP进行pre compile的时候。
　　
　　如果你的WEB APP下都用了大量的第三方jar，其大小超过了jvm默认的大小(4M)那么就会产生此错误信息了。

解决方法： 手动设置MaxPermSize大小
　　
　　修改TOMCAT_HOME/bin/catalina.bat，在echo "Using CATALINA_BASE: $CATALINA_BASE"上面加入以下行：
　　 JAVA_OPTS="-server -XX:PermSize=64M -XX:MaxPermSize=128m
　　建议：将相同的第三方jar文件移置到tomcat/shared/lib目录下，这样可以减少jar 文档重复占用内存

1。参数的含义

-vmargs -Xms128M -Xmx512M -XX:PermSize=64M -XX:MaxPermSize=128M

参数中-vmargs的意思是设置JVM参数，所以后面的其实都是JVM的参数了，我们首先了解一下JVM内存管理的机制，然后再解释每个参数代表的含义。
堆(Heap)和非堆(Non-heap)内存
按照官方的说法：“Java 虚拟机具有一个堆，堆是运行时数据区域，所有类实例和数组的内存均从此处分配。堆是在 Java 虚拟机启动时创建的。”“在JVM中堆之外的内存称为非堆内存(Non-heap memory)”。可以看出JVM主要管理两种类型的内存：堆和非堆。简单来说堆就是Java代码可及的内存，是留给开发人员使用的；非堆就是JVM留给自己用的，所以方法区、JVM内部处理或优化所需的内存(如JIT编译后的代码缓存)、每个类结构(如运行时常数池、字段和方法数据)以及方法和构造方法的代码都在非堆内存中。
堆内存分配
JVM初始分配的内存由-Xms指定，默认是物理内存的1/64；JVM最大分配的内存由-Xmx指定，默认是物理内存的1/4。默认空余堆内存小于40%时，JVM就会增大堆直到-Xmx的最大限制；空余堆内存大于70%时，JVM会减少堆直到-Xms的最小限制。因此服务器一般设置-Xms、-Xmx相等以避免在每次GC 后调整堆的大小。
非堆内存分配
JVM使用-XX:PermSize设置非堆内存初始值，默认是物理内存的1/64；由XX:MaxPermSize设置最大非堆内存的大小，默认是物理内存的1/4。
JVM内存限制(最大值)
首先JVM内存限制于实际的最大物理内存，假设物理内存无限大的话，JVM内存的最大值跟操作系统有很大的关系。简单的说就32位处理器虽然可控内存空间有4GB,但是具体的操作系统会给一个限制，这个限制一般是2GB-3GB（一般来说Windows系统下为1.5G-2G，Linux系统下为2G-3G），而64bit以上的处理器就不会有限制了。

2. 为什么有的机器我将-Xmx和-XX:MaxPermSize都设置为512M之后Eclipse可以启动，而有些机器无法启动？

通过上面对JVM内存管理的介绍我们已经了解到JVM内存包含两种：堆内存和非堆内存，另外JVM最大内存首先取决于实际的物理内存和操作系统。所以说设置VM参数导致程序无法启动主要有以下几种原因：
1) 参数中-Xms的值大于-Xmx，或者-XX:PermSize的值大于-XX:MaxPermSize；
2) -Xmx的值和-XX:MaxPermSize的总和超过了JVM内存的最大限制，比如当前操作系统最大内存限制，或者实际的物理内存等等。说到实际物理内存这里需要说明一点的是，如果你的内存是1024MB，但实际系统中用到的并不可能是1024MB，因为有一部分被硬件占用了。

3. 为何将上面的参数写入到eclipse.ini文件Eclipse没有执行对应的设置？
那为什么同样的参数在快捷方式或者命令行中有效而在eclipse.ini文件中是无效的呢？这是因为我们没有遵守eclipse.ini文件的设置规则：
参数形如“项 值”这种形式，中间有空格的需要换行书写，如果值中有空格的需要用双引号包括起来。比如我们使用-vm C:\Java\jre1.6.0\bin\javaw.exe参数设置虚拟机，在eclipse.ini文件中要写成这样：
-vm
C:\Java\jre1.6.0\bin\javaw.exe
按照上面所说的，最后参数在eclipse.ini中可以写成这个样子：
-vmargs
-Xms128M
-Xmx512M
-XX:PermSize=64M
-XX:MaxPermSize=128M
实际运行的结果可以通过Eclipse中“Help”-“About Eclipse SDK”窗口里面的“Configuration Details”按钮进行查看。
另外需要说明的是，Eclipse压缩包中自带的eclipse.ini文件内容是这样的：
-showsplash
org.eclipse.platform
--launcher.XXMaxPermSize
256m
-vmargs
-Xms40m
-Xmx256m
其中–launcher.XXMaxPermSize（注意最前面是两个连接线）跟-XX:MaxPermSize参数的含义基本是一样的，我觉得唯一的区别就是前者是eclipse.exe启动的时候设置的参数，而后者是eclipse所使用的JVM中的参数。其实二者设置一个就可以了，所以这里可以把–launcher.XXMaxPermSize和下一行使用#注释掉。

3. 其他的启动参数。 如果你有一个双核的CPU，也许可以尝试这个参数:

-XX:+UseParallelGC

让GC可以更快的执行。（只是JDK 5里对GC新增加的参数）

补充：

可以在myelipse里选中相应的服务器比如tomcat5，展开里面的JDK子项页面，来增加服务器启动的JVM参数设置：

-Xms128m
-Xmx256m
-XX:PermSize=128M
-XX:MaxNewSize=256m
-XX:MaxPermSize=256m

最近在做Eclipse插件开发的时候，在国际化的问题上遇到这样问题，比如我的plugin.xml文件中，通过%xxx来引用plugin_zh.properties中对应键xxx的信息时，在插件运行时，相应的信息显示不了，后来进过研究，发现是由于在MANIFEST.MF少配置了一项造成的

Bundle-Localization: plugin，

而这一项配置我在Overview标签页上没有找到相应设置的地方，把这个在MANIFEST.MF加上，插件在运行时，就可以显示plugin_zh.properties中定义的消息了。

最近在Eclipse插件开发中遇到这样的问题，我使用如入扩展点

<extension
       point="org.eclipse.debug.ui.launchConfigurationTabs">
    <tab
          class="com.example.launch.SqlDebugTab"
          group="org.eclipse.jdt.debug.ui.launchConfigurationTabGroup.localJavaApplication"
          id=" com.example.launchs.SqlDebugTab"
          name="SqlDebugTab">
       <associatedDelegate
             delegate=" com.example.launch.SqlDebugLaunchDelegate">
       </associatedDelegate>
    </tab>
 </extension>

<extension
          point="org.eclipse.debug.core.launchDelegates">
       <launchDelegate
             delegate=" com.example.launch.SqlDebugLaunchDelegate"
             id=" com.example.launch.SqlDebugLaunchDelegate"
             modes="debug"
             type="org.eclipse.jdt.launching.localJavaApplication">
       </launchDelegate>
    </extension>

也就是在调式Java Application的对话框中，增加一个Tab页，Tab页的名字为SqlDebugTab，在这个Tab页上增加几个复选框，复选框要显示视图的名称，如果用户选择某个复选框，点“Debug”后，将显示指定的视图，可是在com.example.launch.SqlDebugLaunchDelegate类中的launch方法中调用PlatformUI.getWorkbench().getActiveWorkbenchWindow()，得到的对象却为null，调试程序才发现，运行com.example.launch.SqlDebugLaunchDelegate类是，走的是新线程，也就是说点“Debug”按钮时，Eclipse平台启动的是新的线程（非UI线程），而在新线程中是取不到ActiveWorkbenchWindow对象，为了解决这个问题,花费了很多时间，最后终于找到解决方法,在launch方法通过如下程序来显示视图，就可以解决上面遇到的问题：

PlatformUI.getWorkbench().getDisplay().asyncExec(new Runnable() {
            public void run() {
                IWorkbenchWindow window = PlatformUI.getWorkbench()
                        .getActiveWorkbenchWindow();
                if (window != null){
                    window.getActivePage().showView（"……"）；
}
}
}

package com.example.workflow.actions;

import org.eclipse.gef.ui.actions.ActionBarContributor;
import org.eclipse.ui.actions.ActionFactory;

public class WorkflowActionContributor extends ActionBarContributor {

    @Override
    protected void buildActions() {
        
    }
    
    @Override
    protected void declareGlobalActionKeys() {
        addGlobalActionKey(ActionFactory.COPY.getId());
        
    }    

}

在declareGlobalActionKeys增加对复制命令的申明，同时把属性contributorClass指定为这个类，包含全路径。再定义复制动作CopyAction，代码如下：

package com.example.workflow.actions;

import org.eclipse.gef.ui.actions.SelectionAction;
import org.eclipse.ui.IWorkbenchPart;
import org.eclipse.ui.actions.ActionFactory;

public class CopyAction extends SelectionAction{

    public CopyAction(IWorkbenchPart part) {
        super(part);
        setId(ActionFactory.COPY.getId());
    }

    @Override
    protected boolean calculateEnabled() {        
        return true;
    }

}

注意构造函数中一定要把这个action的id设置为ActionFactory.COPY.getId()，和前面统一起来；

到这儿还没有结束，还必须在编辑器类中注册这个action，覆盖编辑器父类中的createActions()方法：

protected void createActions() {
    super.createActions();

    CopyAction copyAction = new CopyAction((IWorkbenchPart) this);
    getActionRegistry().registerAction(copyAction);
    getSelectionActions().add(copyAction.getId());
}

public void run() {
    Clipboard.getDefault().setContents(super.getSelectedObjects());
}

这样当我们点复制按钮之后，流程设计器就把我们选择的内容放到剪切板上，下一步要做的就是粘贴了。

要使粘贴按钮可用，所做的修改和复制类似，在类WorkflowActionContributor 的方法declareGlobalActionKeys中增加addGlobalActionKey(ActionFactory.PASTE.getId())

增加PasteAction类，代码如下：

package com.example.workflow.actions;

import org.eclipse.gef.ui.actions.Clipboard;
import org.eclipse.gef.ui.actions.SelectionAction;
import org.eclipse.ui.IWorkbenchPart;
import org.eclipse.ui.actions.ActionFactory;

public class PasteAction extends SelectionAction{

    public PasteAction(IWorkbenchPart part) {
        super(part);
        setId(ActionFactory.PASTE.getId());
    }

    @Override
    protected boolean calculateEnabled() {        
        if(Clipboard.getDefault().getContents()!=null){
            return true;
        }else{
            return false;
        }
    }

}

PasteAction pasteAction = new PasteAction((IWorkbenchPart) this);
getActionRegistry().registerAction(pasteAction);
getSelectionActions().add(pasteAction.getId());

public void run() {
        List list = (List)Clipboard.getDefault().getContents();
        for(int i=0;i<list.size();i++){
            AbstractActivityEditPart part = (AbstractActivityEditPart)list.get(i);
            AbstractActivity model = (AbstractActivity)part.getModel();
            WorkflowProcess parent = (WorkflowProcess)part.getParent().getModel();
            AbstractActivity clone = new AbstractActivity();
            clone.setName("CloneActivity");
            clone.setLocation(model.getLocation());
            clone.setSize(model.getSize());
            clone.setFigure(model.getFigure());
            parent.addChild(clone);
        }
    }