在用户界面中,如何显示扩展,显示在何处?
这在很大程度上是一个温和的提示,因为我们已得到了答案。我们希望对一个或多个选中的方法显示上下文菜单选项,这些菜单选项允许我们只用一个操作就可以更改方法的可视性。我们更喜欢在可以显示方法的任何地方都能使用这些菜单选项,如在 Hierarchy 视图和 Package Explorer 中。这把我们带到下一个问题。
通常如何扩展用户界面?
通过示例来学习会更有趣,这方面 Plug-in Project 向导可以提供帮助,它提供了一些样本代码,我们可以修改这些代码来满足我们的需要。我们将回答该向导中的几个问题,它将自动启动用于插件开发的专门透视图,称为 Plug-in Development Environment(PDE),以准备测试。该向导包含了可以帮助我们入手的许多示例。事实上,我们的老朋友“Hello World”也在那里。为了沿袭这个传统,我们将生成这个“Hello World”,查看结果以验证是否正确安装了该环境,随后修改它以帮助我们回答当前的问题,并把我们带到下一个问题:对用户界面的扩展如何知道类似于“选择”这样的基本事件?这很重要,因为我们希望将我们新近引入的菜单选项应用到当前选中的方法上。
请注意,这些指示信息假定您正从全新的 Eclipse 安装开始。如果修改了该环境或更改了首选项,那么可能不会完全象如下所述那样工作。您可以考虑从全新的工作空间启动 Eclipse:打开命令提示符窗口,更改到 /eclipse 目录,然后使用 -data 参数启动 Eclipse,如清单 1 所示。
清单 1. 启动全新的 Eclipse 实例
从使用 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
并不需要过于深入地研究这个代码。我们“旅行”的第 II 部分的目的只是让您熟悉一些基本机制,借此我们可以介绍 JDT 的扩展。这里,您会看到这样一种技术的一个样本:它将菜单和菜单选项作为操作集添加到工作台。它以一个用 标记声明的扩展开始。工作台用户界面插件定义了这个扩展点 org.eclipse.ui.actionSets,以及几个类似的扩展点,通过这几个扩展点可以向各种用户界面元素提供其它插件。
我们还未回答如何将菜单选项添加到 Java 方法的上下文菜单中。一个简单示例可以给我们一些提示。首先打开显示“Hello, World”消息的类 SampleAction,请注意其 run 方法。它不是特别有趣;不过我们还看到了另一个方法 selectionChanged。啊哈!下一个问题的答案有了。
对用户界面的扩展如何知道类似于“选择”这样的基本事件?
工作台“选择”更改时会告知所提供的操作(象我们提供的菜单下拉选项)。这在 selectionChanged 方法前面的 Javadoc 注释中得到了确认。让我们修改这个方法以告知有关“选择”的更多信息。首先,如果您还没有关闭工作台的运行时实例,那么现在就关闭。然后对 selectionChanged 方法添加清单 3 中的代码。
清单 3. selectionChanged 方法,首次修改
有了这个调试代码,我们将看到选择了什么,并了解到有关什么使 Eclipse 工作的更多信息。保存该方法,然后重新启动运行时工作台。
重要:Eclipse 有一个延迟装入的策略,以在用户执行需要插件代码的操作时才装入插件。所以您必须先选择 Sample Action 菜单选项,以在调用 selectionChanged 方法之前装入您的插件。
现在选择其它东西,如编辑器中的文本、Navigator 中的文件,当然还有 Outline 视图中的成员(回忆一下:您必须创建一个 Java 项目和示例 Java 类来做到这一点,因为运行时实例使用不同的工作空间)。清单 4 显示了您将在 Eclipse 的开发实例的控制台中看到的某个示例输出。
清单 4. selectionChanged 输出,首次修改
唔,这不如我们所希望的那么有启发性。很明显,这个“选择”不象 String 的实例那么基本,但没有明示涉及了什么类,因为这些类很明显覆盖了它们的缺省 toString 方法。如果不用多做一点研究就可以明白这些类向我们显示的信息,那我们就轻松了,但目前我们还没有达到这种程度。回到 selectionChanged 方法,浏览 selection 参数的接口 ISelection 的层次结构。其层次结构表明它的通用子类型接口并不多,只有 IStructuredSelection(用于列表)和 ITextSelection。通过输出所选的类,我们可以使 selectionChanged 方法稍微更智能一点。如清单 5 所示修改 selectionChanged 方法。
清单 5. selectionChanged 方法,第二次修改
同样,请记住关闭运行时实例,然后重新启动。现在当您选择用户界面的各种元素时,它们是不是提供了更多信息,如清单 6 所示。
清单 6. selectionChanged 输出,第二次修改
特别地,我们确认在用户界面中看到的东西与 JDT 模型类一一对应。我们之所以了解所显示的是作为选择的模型,而不是类似于字符串和图像的较低级的基本类型,要归功于另一个 Eclipse 框架,称为 JFace。这个框架在象字符串这样的基本类型(接近操作系统的窗口小部件希望使用这些基本类型)和更高级的模型对象(您的代码更愿意使用这些对象)之间进行映射。本文只是略微提及这个主题,因为我们设定的目标是扩展 JDT。参考资料一节推荐了有关 JFace 的其它参考资料,它们将拓展您的理解。本文将只讨论理解 JDT 扩展的基础所必需的知识。
回到输出,特殊的选项结果引起了我们的注意:它们对应于用户界面中 Java 成员的选择。清单 7 中重复了它们。
清单 7. selectionChanged 输出,再次研究
这些类的包名中间的 internal 使人有点担心。但是,正如您通常会发现的,Eclipse 会有一个公共(public)接口,它对应于(内部)实现类,就如这里的例子。快速类查找揭示出:这些类都实现了看来很有希望成为这个问题答案的一组公共接口,也就是 ISourceReference、IJavaElement,尤其还有 IMember。最后!现在我们可以开始早就希望进行的扩展,这使我们去回答下一个问题。
这在很大程度上是一个温和的提示,因为我们已得到了答案。我们希望对一个或多个选中的方法显示上下文菜单选项,这些菜单选项允许我们只用一个操作就可以更改方法的可视性。我们更喜欢在可以显示方法的任何地方都能使用这些菜单选项,如在 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;您还有一页要完成)。
![](http://tech.ccidnet.com/pub/attachment/2004/5/296009.jpg)
图 4. Simple Plug-in Content
您可以在下一页(显示在图 5 中)中指定参数,这些参数对于“Hello, Worlds”示例是唯一的,比如,将要显示的消息。
![](http://tech.ccidnet.com/pub/attachment/2004/5/296011.jpg)
图 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...下拉菜单选项上添加/删除操作集)。
![](http://tech.ccidnet.com/pub/attachment/2004/5/296013.jpg)
图 6. Hello, Eclipse world
让我们快速浏览一下插件清单文件 plugin.xml。双击它,以在 Plug-in Manifest 编辑器中打开它。这个编辑器提供了几个类似于向导的页和一个“原始”源代码页。通过选择 Source 选项卡转到源代码页。您将看到与以下清单 2 显示的代码相似的内容;我们感兴趣的是用粗体显示的那几部分。
清单 2. 所生成的“Hello, World” plugin.xml
<extension point="org.eclipse.ui.actionSets">> <actionSet label="Sample Action Set" visible="true" id="com.ibm.lab.helloworld.actionSet"> <menu label="Sample &Menu" id="sampleMenu"> <separator name="sampleGroup"> </separator> </menu> <action 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"> </action> </actionSet> </extension> |
并不需要过于深入地研究这个代码。我们“旅行”的第 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 <empty selection> ==========> selectionChanged org.eclipse.jface.text.TextSelection@9fca283 ==========> selectionChanged <empty selection> ==========> 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.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]] ==========> selectionChanged <empty selection> ==========> selectionChanged [ChangeIMemberFlagAction.java [in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]] package com.ibm.lab.soln.jdt.excerpt import org.eclipse.jdt.core.Flags import org.eclipse.jdt.core.IBuffer ...lines omitted... void selectionChanged(IAction, ISelection)] ==========> selectionChanged [boolean isChecked(IAction, IMember) [in ToggleIMemberFinalAction [in ToggleIMemberFinalAction.java [in com.ibm.lab.soln.jdt.excerpt [in src [in com.ibm.lab.soln.jdt.excerpt]]]]]] |
唔,这不如我们所希望的那么有启发性。很明显,这个“选择”不象 String 的实例那么基本,但没有明示涉及了什么类,因为这些类很明显覆盖了它们的缺省 toString 方法。如果不用多做一点研究就可以明白这些类向我们显示的信息,那我们就轻松了,但目前我们还没有达到这种程度。回到 selectionChanged 方法,浏览 selection 参数的接口 ISelection 的层次结构。其层次结构表明它的通用子类型接口并不多,只有 IStructuredSelection(用于列表)和 ITextSelection。通过输出所选的类,我们可以使 selectionChanged 方法稍微更智能一点。如清单 5 所示修改 selectionChanged 方法。
清单 5. selectionChanged 方法,第二次修改
public void selectionChanged(IAction action, ISelection selection) { System.out.println("==========> selectionChanged"); if (selection != null) { if (selection instanceof IStructuredSelection) { IStructuredSelection ss = (IStructuredSelection) selection; if (ss.isEmpty()) System.out.println("<empty selection>"); else System.out.println("First selected element is " + ss.getFirstElement().getClass()); } else if (selection instanceof ITextSelection) { ITextSelection ts = (ITextSelection) selection; System.out.println("Selected text is <" + ts.getText() + ">"); } } else { System.out.println("<empty selection>"); } } |
同样,请记住关闭运行时实例,然后重新启动。现在当您选择用户界面的各种元素时,它们是不是提供了更多信息,如清单 6 所示。
清单 6. selectionChanged 输出,第二次修改
????selected some methods in the Outline view ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.SourceMethod ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.SourceMethod ==========> selectionChanged <selection is empty> activated the Java editor ==========> selectionChanged Selected text is <isChecked> ==========> selectionChanged <selection is empty> selected same methods and classes, package in the Package Explorer ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.SourceMethod ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.SourceType ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.PackageFragment activated the Navigator view, selected some files, folders, and projects ==========> selectionChanged First selected element is class org.eclipse.core.internal.resources.File ==========> selectionChanged <selection is empty> ==========> selectionChanged First selected element is class org.eclipse.core.internal.resources.File ==========> selectionChanged First selected element is class org.eclipse.core.internal.resources.Project ==========> selectionChanged First selected element is class org.eclipse.core.internal.resources.Folder ==========> selectionChanged <selection is empty> reactivated the Package Explorer, selected some classes and methods in JARs of reference libraries ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.JarPackageFragment ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.ClassFile ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.BinaryMethod |
特别地,我们确认在用户界面中看到的东西与 JDT 模型类一一对应。我们之所以了解所显示的是作为选择的模型,而不是类似于字符串和图像的较低级的基本类型,要归功于另一个 Eclipse 框架,称为 JFace。这个框架在象字符串这样的基本类型(接近操作系统的窗口小部件希望使用这些基本类型)和更高级的模型对象(您的代码更愿意使用这些对象)之间进行映射。本文只是略微提及这个主题,因为我们设定的目标是扩展 JDT。参考资料一节推荐了有关 JFace 的其它参考资料,它们将拓展您的理解。本文将只讨论理解 JDT 扩展的基础所必需的知识。
回到输出,特殊的选项结果引起了我们的注意:它们对应于用户界面中 Java 成员的选择。清单 7 中重复了它们。
清单 7. selectionChanged 输出,再次研究
==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.SourceMethod ==========> selectionChanged First selected element is class org.eclipse.jdt.internal.core.BinaryMethod |
这些类的包名中间的 internal 使人有点担心。但是,正如您通常会发现的,Eclipse 会有一个公共(public)接口,它对应于(内部)实现类,就如这里的例子。快速类查找揭示出:这些类都实现了看来很有希望成为这个问题答案的一组公共接口,也就是 ISourceReference、IJavaElement,尤其还有 IMember。最后!现在我们可以开始早就希望进行的扩展,这使我们去回答下一个问题。