Sung in Blog

           一些技术文章 & 一些生活杂碎
编写Eclipse插件的方法很简单,你只需要编写一个应用程序,并把它"添加"到Eclipse上。但是与编写音乐类似,在能够创作一部著作之前,首先必须学习大量的相关知识。
  
  本文将讨论少许几个简单的GUI元素:
  
  · 工具条按钮
  
  · 菜单项
  
  · 对话框
  
  为了使用这些元素,我们将稍微修改已有的插件,顺便编写一个可供使用的工具类。
  
  扩展点(Extension Points)
  
  我们不能随意地向Eclipse用户界面的任何地方添加窗口小部件,只能在特殊的、指定的、有记载的位置添加。这些位置被称为扩展点(extension points)。在基本的Eclipse安装中存在数以百计可供使用的扩展点。插件自身也可以发布新的扩展点。
  
 

  
图1:扩展页

  
  现在请点击"添加"(ADD)按钮,出现了图2所示的列表。
  
 

  
图2:新增扩展向导,扩展列表

  
  上下滚动这个列表可以看到很多可供使用的扩展点。你可能注意到了有两种类型的扩展点:带有扩展模板的(用加号标识)和不带扩展模板的。大多数经常用到的扩展点都带有用于辅助开发扩展的模板。图2中选择的扩展点Action Set,带有一个叫做"Hello World"操作集的模板。当你选择某个模板的时候,会出现简短的描述。"下一个"页面将询问模板使用的参数。
  
  现在请关闭向导并返回到"扩展"属性页。选择"Invokatron编辑器"。在这个属性页中,你可能注意到了我们在向导中为Invokatron编辑器输入的信息。正常的扩展需要一个唯一的标识符(ID字段)、一个供显示的名称(Name字段)和它所属的扩展点(Point字段)。从模板中建立的扩展(例如Invokatron编辑器)需要更多的参数。没有模板的扩展点也需要更多的信息,但是这些信息只能在文本编辑器中输入。
  
  添加工具条按钮
  
  现在我们已经了解了扩展点是什么,让我们来添加一个扩展吧。我们首先添加的是一个工具条按钮。这个按钮将调用我们前面建立的新的Invokatron向导。
  
  添加工具条按钮有三个步骤:
  
  1.声明一个新扩展。
  
  2.用特定的标记来扩充该声明。
  
  3.编写操作委托类
  
  1.声明一个新扩展
  
  我们已经知道怎样实现这个步骤了。简单地返回到扩展点下的plugin.xml编辑器。点击"添加"。工具条按钮在org.eclipse.ui.actionSets扩展点下面。不要使用模板,直接点击"完成"。输入下面一些内容:
  
  · Id: NewInvokatronAction
  
  · Name: New Invokatron Document Action
  
  · Point: (使用默认值:org.eclipse.ui.actionSets)
  
  返回plugin.xml属性页,Eclipse给这个文件添加了新的代码片断。
  
  2.用特定的标记来扩充该声明
  
  这个新扩展几乎毫无内容。我们在下面添加一些标记(tag)。你知道可以使用哪些标记吗?你可以右键点击"所有扩展"树中的元素,选择"新增"菜单,会得到一个列表。你也可以查看Eclipse文档。
  
  现在我们看到自己可以在<extension>标记内部添加一个<actionSet>标记。它可以包含零个或多个<menu>标记,后面跟着零个或多个<action>标记,还可以选择使用<description>标记。但是其中最重要的标记是<action>。它可以同时描述工具条按钮和菜单项。>BR>下面是我们将添加的工具条按钮的XML代码片断。其中的新代码是黑体的。我们在后面会剖析这段代码。
  
  <extension id="NewInvokatronAction"
  name="New Invokatron Document Action"
  point="org.eclipse.ui.actionSets">
  <actionSet id="invokatron.actionSet"
  label="Invokatron Actions"
  visible="true">
  <action id="invokatron.wizard.RunWizardAction"
  toolbarPath="org.eclipse.ui.workbench.file/new.ext"
  icon="icons/InvokatronIcon16.gif"
  tooltip="Starts the New Invokatron Document Wizard."
  class="invokatron.wizard.RunWizardAction">
  </action>
  </actionSet>
  </extension>
  
  所有这些操作都可以在plugin.xml编辑器中用图形化的方式来完成,但是我们查看XML以明确字段的完整文本内容。此处的<actionSet>标记只含有一个操作(action)。操作表现为菜单中的项或工具条中的按钮的对象。操作的属性实在太多了,你可以在在线文档中查阅。其中最有趣的一些属性是:
  
  · id:操作的唯一标识符。可以用于在运行时引用操作。
  
  · toolbarPath:放置工具条按钮的位置。
  
  · icon:工具条按钮或菜单项左侧显示的图标。它是一个与开发目录关联的16×16的GIF文件。请把 图片存放到Invokatron\icons文件夹中。这个文件夹已经被包含到二进制建立路径中,因此该图标将放入插件的文档目录中。
  
  · tooltip:当鼠标停留在工具条按钮上的时候出现的文本内容。
  
  · class:这些操作的完整的合格的类名称。
  
  关于工具条路径
  
  工具条路径(toolbar path)指出了添加工具条按钮的位置。由于任何人都可以建立工具条,而且有时候一个按钮可以包含子选项,因此我们用分层的标识符列表来访问这个位置。下面是经常用到的工具条列表和它们的路径:
  
  · 文件: org.eclipse.ui.workbench.file 带有一些公共的分组标志(你可以添加按钮的更多的位置):
  
  o "新建"区:new.ext
  o "保存"区:save.ext
  o "打印"区:print.ext
  o "建立"区:build.ext
  
  · 导航: org.eclipse.ui.workbench.navigate
  
  · 载入: org.eclipse.debug.ui.launchActionSet
  
  · 编辑器表示:org.eclipse.ui.edit.text.actionSet.presentation
  
  · 搜索: org.eclipse.search.searchActionSet
  
  · Java元素建立:org.eclipse.jdt.ui.JavaElementCreationActionSet
  
  · 组: Team
  
  · CVS: CVS
  
  如果你提供的工具条ID不带有标志ID,你的按钮就会被添加到紧挨着这个工具条的一个新工具条之上。接着这个新工具条就可以被添加到Eclipse GUI上了。有时候你会看到使用工具条路径"正常的(Normal)"的插件。这是旧的名称转换。在Eclipse 3中这样使用的时候会建立一个叫作"Normal"的新工具条。如果你建立一个新工具条ID,你的工具条会被添加到"文件"工具条后面。
  
  请注意"文件"工具条的"新建"组标志。这是我们添加自己的按钮的地方。由于标志ID是new.ext,完整的路径就是:
  
  org.eclipse.ui.workbench.file/new.ext
  
  3.编写操作委托类
  
  最后一步是编写少量的用于实现操作的Java。这个类称为操作委托。
  
  package invokatron.wizard;
  
  public class RunWizardAction extends Action
  implements IWorkbenchWindowActionDelegate {
  /** 操作被建立的时候调用*/
  public void init(IWorkbenchWindow window) {}
  
  /** 操作被删除的时候调用*/
  public void dispose() {}
  
  /** 操作被执行的时候调用 */
  public void run(IAction action) {
  InvokatronWizard wizard= new InvokatronWizard();
  Shell shell = PlatformUI.getWorkbench().getActiveWorkbenchWindow().getShell();
  WizardDialog dialog= new WizardDialog(shell, wizard);
  dialog.create();
  dialog.open();
  }
  
  /** 编辑器中的对象被选中或取消选择的时候调用*/
  public void selectionChanged(IAction action, ISelection selection) {}
  }
  
  添加菜单项
  
  你也许猜到了添加菜单项与添加工具条按钮的过程几乎相同。你也必须声明一个扩展(同种类型的)、用特定的标记(相同的标记)来扩充它,并编写操作类(相同的类)。其主要的不同点是扩展的声明。下面是菜单项的扩展XML代码(没有相应的工具条按钮):
  
  <extension id="NewInvokatronAction"
  name="New Invokatron Document Action"
  point="org.eclipse.ui.actionSets">
  <actionSet id="invokatron.actionSet"
  label="Invokatron Actions"
  visible="true">
  <action id="invokatron.wizard.RunWizardAction"
  label="New Invokatron"
  menubarPath="file/new.ext"
  icon="icons/InvokatronIcon16.gif"
  tooltip="Starts the New Invokatron Document Wizard."
  class="invokatron.wizard.RunWizardAction">
  </action>
  </actionSet>
  </extension>
  
  标签(label)属性包含了显示在菜单项上的文本内容。键盘快捷键用"&"符号表示,在XML中是&。下面是一个组合了菜单项和工具条按钮的例子:
  
  <extension id="NewInvokatronAction"
  name="New Invokatron Document Action"
  point="org.eclipse.ui.actionSets">
  <actionSet id="invokatron.actionSet"
  label="Invokatron Actions"
  visible="true">
  <action id="invokatron.wizard.RunWizardAction"
  label="New Invokatron"
  menubarPath="file/new.ext"
  toolbarPath="org.eclipse.ui.workbench.file/new.ext"
  icon="icons/invokatronPicture.gif"
  tooltip="Starts the New Invokatron Document Wizard."
  class="invokatron.wizard.RunWizardAction">
  </action>
  </actionSet>
  </extension>
  
  菜单与工具条只有稍微的不同。工具条只有一个"层次",而菜单有完整的层次。这也是用操作来声明菜单这种方法可行的原因。菜单都列举在<actionSet>标记之中,在<action>标记之上。它们的语法如下:
  
  <menu id="unique.ID"
  <!-- New menu at the top-level. The menubarPath
  for actions inside this menu is: Special -->
  path="Special"
  label="This is a parent menu item.">
  <!-- Optional, the menubarPath for actions after
  this separator is: Special/BelowBar -->
  <separator name="BelowBar">
  </menu>
  
  关于菜单条路径
  
  菜单条路径(menubar path)指出了添加菜单项的位置。我们使用分层的标识符列表来访问这个位置。下面是经常使用的菜单条列表以及它们的路径和公共组标志:
  
  · 文件:file
  
  o "开始" 区:fileStart
  
  o "新建"菜单内部的"附加"组标志: new/additions
  
  o "新建"区,在"新建"菜单下面:new.ext
  
  o "关闭" 区:close.ext
  
  o "保存" 区:save.ext
  
  o "打印" 区:print.ext
  
  o "打开" 区:open.ext
  
  o "导入" 区:import.ext
  
  o "附加" 区:additions
  
  o "最近的文档" 区:mru
  
  o "结束" 区:fileEnd
  
  · 编辑: edit
  
  o "开始" 区:editStart
  
  o "撤销" 区:undo.ext
  
  o "剪切" 区:cut.ext
  
  o "查找" 区:find.ext
  
  o "添加" 区:add.ext
  
  o "结束" 区(有时不是结束):fileEnd
  
  o "附加" 区:additions
  
  · 源: org.eclipse.jdt.ui.source.menu
  
  · 重构: org.eclipse.jdt.ui.refactoring.menu
  
  · 导航: navigate
  
  o "开始"区:navStart
  
  o "Go To"菜单中的"附加"组标志: goTo/additions
  
  o "打开"区(有四个):open.ext, open.ext2, open.ext3, and open.ext4
  
  o "显示"区(有四个):show.ext, show.ext2, show.ext3, and show.ext4
  
  o "附加"区:additions
  
  o "结束"区:navEnd
  
  · 搜索: org.eclipse.search.menu
  
  · 项目: project
  
  o "开始"区:projStart
  
  o "打开"区:open.ext
  
  o "建立"区:build.ext
  
  o "附加"区:additions
  
  o "结束"区:projEnd
  
  · 载入: launch
  
  · 运行: org.eclipse.ui.run
  
  · "附加"组标志:additions
  
  · 窗口: window
  
  o "附加"区:additions
  
  o "结束"区:additionsend
  
  · 帮助: help
  
  o "开始"区:helpStart
  
  o "主要组"区:group.main.ext
  
  o "教程组"区:group.tutorials
  
  o "工具组"区:group.tools
  
  o "更新组"区:group.updates
  
  o "结束"区(有时候不是结束): helpEnd
  
  o "附加"区:additions
  
  o "关于组"区:group.about.ext
  
  如果你提供的菜单条ID不带有标志ID,那么你的菜单项将出现在这个菜单条的后面。如果你建立了一个新菜单条ID,你的菜单条就被添加到"项目"和"运行"菜单之间。
  
  Eclipse开发者提示:请让工具条和菜单条ID、标志位置保持一致性。
  
  请注意"文件"菜单的"新建"组标志。这是我们添加自己的菜单的位置。由于它的标志ID是new.ext,所以完整的路径是:file/new.ext
  
  结果
  
  操作集合中还有其它一些特性可供使用,包括快捷键、状态按钮、浮动图标、帮助内容和窗体工具条等等。操作集合只是记载的数十个扩展点中的一种类型的扩展。因此我们看到的只是冰山一角。但是至少它使我们理解了扩展点是如何工作的。我们看到的这些过程都是很好的。
  
  在讲解向导自定义之前,我们看一下图3所显示的新工具条按钮和菜单项:
  
 

  
图3:新的菜单项和工具条按钮

  
  标准对话框
  
  Eclipse提供了所有的标准对话框和建立自定义对话框的简单途径。大多数标准对话框都是由org.eclipse.jface.dialogs.MessageDialog类提供的。这个类含有很多用于建立标准对话框的静态方法。下面表格列举了我们可以使用的标准对话框。
  
 

  有人可能认为使用标准对话框的时候,JOptionPane类比MessageDialog提供了更大的灵活性。但是归根结底,在MessageDialog的构造函数和自定义对话框的帮助下,你几乎可以实现所有的事务。MessageDialog中缺少而JOptionPane拥有的唯一的特性是在HTML中直接进行消息格式化。但是使用自定义对话框的时候是可以实现这种功能的。
  
  对话框辅助类
  
  现在我们知道了可供选择的类型了,让我们来建立Invokatron需要的对话框吧。有两个地方需要对话框:
  
  · 代码生成过程的确认信息,是否覆盖前面的代码。
  
  · 输入一个值的对话框(与JOptionPane.showInputDialog()类似)。
  
  这个类中的第一个方法是用于确认代码覆盖的:
  
  public static boolean openOverwriteDialog(Shell parent) {
  return MessageDialog.openConfirm(parent,
  "Confirmation",
  "You are about to overwrite your class. " +
  "Are you sure you want to continue?");
  }
  
  上面的代码非常简单,我们仅仅建立了一个常规的确认对话框。输入对话框有点麻烦:MessageDialog没有输入字段。我们只能建立一个新对话框类,可以是Dialog的子类。我们也可以建立MessageDialog的子类并重载它的createCustomArea()方法,添加输入字段。但是我们还有更简单的方法。
  
  我们将使用InputDialog类:
  
  public static String openInputDialog(
  Shell parent,
  String title,
  String question,
  String initialValue) {
  
  InputDialog dlg = new InputDialog(
  parent,
  title,
  question,
  initialValue,
  null); //这是一个可供选择的有效的类
  dlg.open();
  
  if(dlg.getReturnCode()!=Window.OK) //点击"确认"了吗?
  return null;
  
  return dlg.getValue();
  }
  
  我们的对话框辅助类完成了。你可以在图4中看到这些对话框。
  

  
图4:对话框

  
  Eclipse交响乐
  
  Eclipse与音乐类似;一旦你学会了如何使用那些可供使用的乐器,你就能编写自己的交响乐了。在本文中我们简短地了解了两类工具:扩展点和对话框。
posted on 2005-11-02 15:35 Sung 阅读(1413) 评论(0)  编辑  收藏 所属分类: Eclipse

只有注册用户登录后才能发表评论。


网站导航: