扩展Eclipse的Java开发工具(二)
在用户界面中，如何显示扩展，显示在何处？
这在很大程度上是一个温和的提示，因为我们已得到了答 案。我们希望对一个或多个选中的方法显示上下文菜单选项，这些菜单选项允许我们只用一个操作就可以更改方法的可视性。我们更喜欢在可以显示方法的任何地方 都能使用这些菜单选项，如在 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.1eclipse |
从 使用 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 &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) { |
有了这个调试代码，我们将看到选择了什么，并了解到有关什么使 Eclipse 工作的更多信息。保存该方法，然后重新启动运行时工作台。
重要：Eclipse 有一个延迟装入的策略，以在用户执行需要插件代码的操作时才装入插件。所以您必须先选择 Sample Action 菜单选项，以在调用 selectionChanged 方法之前装入您的插件。
现 在选择其它东西，如编辑器中的文本、Navigator 中的文件，当然还有 Outline 视图中的成员（回忆一下：您必须创建一个 Java 项目和示例 Java 类来做到这一点，因为运行时实例使用不同的工作空间）。清单 4 显示了您将在 Eclipse 的开发实例的控制台中看到的某个示例输出。
清单 4. selectionChanged 输出，首次修改
==========> selectionChanged |
唔， 这不如我们所希望的那么有启发性。很明显，这个“选择”不象 String 的实例那么基本，但没有明示涉及了什么类，因为这些类很明显覆盖了它们的缺省 toString 方法。如果不用多做一点研究就可以明白这些类向我们显示的信息，那我们就轻松了，但目前我们还没有达到这种程度。回到 selectionChanged 方法，浏览 selection 参数的接口 ISelection 的层次结构。其层次结构表明它的通用子类型接口并不多，只有 IStructuredSelection（用于列表）和 ITextSelection。通过输出所选的类，我们可以使 selectionChanged 方法稍微更智能一点。如清单 5 所示修改 selectionChanged 方法。
清单 5. selectionChanged 方法，第二次修改
public void selectionChanged(IAction action, ISelection selection) { |
同样，请记住关闭运行时实例，然后重新启动。现在当您选择用户界面的各种元素时，它们是不是提供了更多信息，如清单 6 所示。
清单 6. selectionChanged 输出，第二次修改
????selected some methods in the Outline view |
特 别地，我们确认在用户界面中看到的东西与 JDT 模型类一一对应。我们之所以了解所显示的是作为选择的模型，而不是类似于字符串和图像的较低级的基本类型，要归功于另一个 Eclipse 框架，称为 JFace。这个框架在象字符串这样的基本类型（接近操作系统的窗口小部件希望使用这些基本类型）和更高级的模型对象（您的代码更愿意使用这些对象）之间 进行映射。本文只是略微提及这个主题，因为我们设定的目标是扩展 JDT。参考资料一节推荐了有关 JFace 的其它参考资料，它们将拓展您的理解。本文将只讨论理解 JDT 扩展的基础所必需的知识。
回到输出，特殊的选项结果引起了我们的注意：它们对应于用户界面中 Java 成员的选择。清单 7 中重复了它们。
清单 7. selectionChanged 输出，再次研究
==========> selectionChanged |
这 些类的包名中间的 internal 使人有点担心。但是，正如您通常会发现的，Eclipse 会有一个公共（public）接口，它对应于（内部）实现类，就如这里的例子。快速类查找揭示出：这些类都实现了看来很有希望成为这个问题答案的一组公共 接口，也就是 ISourceReference、IJavaElement，尤其还有 IMember。最后！现在我们可以开始早就希望进行的扩展，这使我们去回答下一个问题。
来自 “ ITPUB博客 ” ，链接：http://blog.itpub.net/374079/viewspace-131458/，如需转载，请注明出处，否则将追究法律责任。
转载于:http://blog.itpub.net/374079/viewspace-131458/
1949
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
