扩展Eclipse的Java开发工具(二)

核心提示：在用户界面中，如何显示扩展，扩展Eclipse的Java开发工具(二)，显示在何处？ 这在很大程度上是一个暖和的提示，因为我们已得到了答案，因为运行时实例使用不同的工作空间），清单 4 显示了您将在 Eclipse 的开发实例的控制台中看到的某个示例输出，我们希望对一个或多个选中的方法显示上下文菜单选项，这些菜单选项答

　　在用户界面中，如何显示扩展，显示在何处？
　　这在很大程度上是一个暖和的提示，因为我们已得到了答案。我们希望对一个或多个选中的方法显示上下文菜单选项，这些菜单选项答应我们只用一个操作就可以更改方法的可视性。我们更喜欢在可以显示方法的任何地方都能使用这些菜单选项，如在 Hierarchy 视图和 Package EXPlorer 中。这把我们带到下一个问题。
　　
　　通常如何扩展用户界面？
　　通过示例来学习会更有趣，这方面 Plug-in PRoject 向导可以提供帮助，它提供了一些样本代码，我们可以修改这些代码来满足我们的需要。我们将回答该向导中的几个问题，它将自动启动用于插件开发的专门透视图，称为 Plug-in Development Environment（PDE），以预备测试。该向导包含了可以帮助我们入手的许多示例。事实上，我们的老朋友“Hello World”也在那里。为了沿袭这个传统，我们将生成这个“Hello World”，查看结果以验证是否正确安装了该环境，随后修改它以帮助我们回答当前的问题，并把我们带到下一个问题：对用户界面的扩展如何知道类似于“选择”这样的基本事件？这很重要，因为我们希望将我们新近引入的菜单选项应用到当前选中的方法上。
　　
　　请注重，这些指示信息假定您正从全新的 Eclipse 安装开始。假如修改了该环境或更改了首选项，那么可能不会完全象如下所述那样工作。您可以考虑从全新的工作空间启动 Eclipse：打开命令提示符窗口，更改到 \eclipse 目录，然后使用 -data 参数启动 Eclipse，如清单 1 所示。
　　
　　清单 1. 启动全新的 Eclipse 实例
　　
　　cd c:\eclipse2.1\eclipse
　　eclipse.exe -data workspaceDevWorks
　　
　　从使用 New Plug-in Project 向导创建一个插件项目开始。选择 File > New > Project。在 New Project 对话框中，在向导列表中选择 Plug-in Development and Plug-in Project，然后选择 Next。将项目命名为 com.ibm.lab.helloworld。该向导将根据这个名称创建插件标识，所以它在系统中必须是唯一的（按惯例，项目名和插件标识相同）。使用显示在“Project contents”下面的推荐缺省工作空间位置就可以了；选择 Next。
　　
　　在下一页上，选择 Next 以接受缺省插件项目结构。该插件代码生成器页推荐了许多样本，向导可以帮助您进一步对该项目进行参数化。选择“Hello, World”选项，然后选择 Next。下一页（显示在图 4 中）推荐了插件名和插件类名。这些名称基于插件项目 com.ibm.lab.helloworld 的最后一个单词。这个示例不需要任何插件类便利方法，所以取消对三个代码生成选项的选择（如图 4 所示），然后选择 Next（不是 Finish；您还有一页要完成）。
　　　
　　图 4. Simple Plug-in Content
　　您可以在下一页（显示在图 5 中）中指定参数，这些参数对于“Hello, Worlds”示例是唯一的，比如，将要显示的消息。
　　　
　　图 5. Sample Action Set
　　要简化所产生的代码，将该操作的目标包名从 com.ibm.lab.helloworld.actions 更改成 com.ibm.lab.helloworld，即与该项目的名称相同。尽管在实际的插件中，您可以选择用不同的包对相关的类进行分组，但在本例中，只有两个类，所以不必这样做。这样也遵循了“主”包名和项目名相同这个惯例。现在选择 Finish。
　　
　　您应该看到一个信息消息：“Plug-ins required to compile java classes in this plug-in are currently disabled. The wizard will enable them to avoid compile errors.”。选择 OK 继续。假如这是个全新的工作空间，那么您还将看到另一个信息消息：“This kind of project is associated with the Plug-in Development Perspective. Do you want to switch to this perspective now?”。 选择 Yes 以根据这个消息的建议进行切换。
　　
　　要验证所有的东西是否都设置正确，让我们测试新插件。选择 Run > Run As > Run-Time Workbench。这将启动 Eclipse 的第二个实例，它将包含您的插件。这个新实例将创建一个新的名为 runtime-workspace 的工作空间目录，所以不必担心；对这个实例所作的任何测试都不会影响开发设置。您应该看到类似图 6 的样子，其中有一个新的下拉菜单，其标签为 Sample Menu，它有单一的选项 Sample Action。选择它将显示下面的信息消息。假如您不是从全新的工作空间启动，那么可以选择 Window > Reset Perspective 以查看新生成的下拉菜单；从现有工作空间启动时不会显示这个菜单，因为工作台“记得”上次 Eclipse 运行时哪些操作集是活动的（您还可以从 Window > Customize Perspective...下拉菜单选项上添加／删除操作集）。
　　
　　图 6. Hello, Eclipse world
　　让我们快速浏览一下插件清单文件 plugin.xml。双击它，以在 Plug-in Manifest 编辑器中打开它。这个编辑器提供了几个类似于向导的页和一个“原始”源代码页。通过选择 Source 选项卡转到源代码页。您将看到与以下清单 2 显示的代码相似的内容；我们感爱好的是用粗体显示的那几部分。
　　
　　清单 2. 所生成的“Hello, World” plugin.xml
　　
　　　　point="org.eclipse.ui.actionSets">>
　　　　　　label="Sample Action Set"
　　　visible="true"
　　　id="com.ibm.lab.helloworld.actionSet">
　　　　　　label="Sample &Menu"
　　　　id="sampleMenu">
　　　　　　　name="sampleGroup">
　　　
　　
　　　　　　label="&Sample Action"
　　　　icon="icons/sample.gif"
　　　　class="com.ibm.lab.helloworld.SampleAction"
　　　　tooltip="Hello, Eclipse world"
　　　　menubarPath="sampleMenu/sampleGroup"
　　　　toolbarPath="sampleGroup"
　　　　id="com.ibm.lab.helloworld.SampleAction">
　　
　　　
　　
　　
　　并不需要过于深入地研究这个代码。我们“旅行”的第 II 部分的目的只是让您熟悉一些基本机制，借此我们可以介绍 JDT 的扩展。这里，您会看到这样一种技术的一个样本：它将菜单和菜单选项作为操作集添加到工作台。它以一个用 标记声明的扩展开始。工作台用户界面插件定义了这个扩展点 org.eclipse.ui.actionSets，以及几个类似的扩展点，通过这几个扩展点可以向各种用户界面元素提供其它插件。
　　
　　我们还未回答如何将菜单选项添加到 Java 方法的上下文菜单中。一个简单示例可以给我们一些提示。首先打开显示“Hello, World”消息的类 SampleAction，请注重其 run 方法。它不是非凡有趣；不过我们还看到了另一个方法 selectionChanged。啊哈！下一个问题的答案有了。
　　
　　对用户界面的扩展如何知道类似于“选择”这样的基本事件？
　　
　　工作台“选择”更改时会告知所提供的操作（象我们提供的菜单下拉选项）。这在 selectionChanged 方法前面的 Javadoc 注释中得到了确认。让我们修改这个方法以告知有关“选择”的更多信息。首先，假如您还没有关闭工作台的运行时实例，那么现在就关闭。然后对 selectionChanged 方法添加清单 3 中的代码。
　　
　　清单 3. selectionChanged 方法，首次修改
　　
　　public void selectionChanged(IAction action, ISelection selection) {
　　　System.out.println("==========> selectionChanged");
　　　System.out.println(selection);
　　}
　　
　　有了这个调试代码，我们将看到选择了什么，并了解到有关什么使 Eclipse 工作的更多信息。保存该方法，然后重新启动运行时工作台。
　　
　　重要：Eclipse 有一个延迟装入的策略，以在用户执行需要插件代码的操作时才装入插件。所以您必须先选择 Sample Action 菜单选项，以在调用 selectionChanged 方法之前装入您的插件。
　　
　　现在选择其它东西，如编辑器中的文本、Navigator 中的文件，当然还有 Outline 视图中的成员（回忆一下：您必须创建一个 Java 项目和示例 Java 类来做到这一点，因为运行时实例使用不同的工作空间）。清单 4 显示了您将在 Eclipse 的开发实例的控制台中看到的某个示例输出。
　　
　　清单 4. selectionChanged 输出，首次修改
　　
　　==========> selectionChanged
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]
　　==========> selectionChanged
　　
　　==========> selectionChanged
　　org.eclipse.jface.text.TextSelection@9fca283
　　==========> selectionChanged
　　
　　==========> selectionChanged
　　[package com.ibm.lab.soln.jdt.excerpt [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]
　　==========> selectionChanged
　　[IMember[] members [in ChangeIMemberFlagAction [in [Working copy] ChangeIMemberFlagAction.java
　　[in com.ibm.lab.so