技术开发 频道

NetBeans IDE 5.0 插件模块快速入门指南

注意关于 GUI Registration 面板中各部分的以下内容: 
  类别。 指定在 Options 窗口的 Keymap 部分中该 action 的位置。
 
  Global Menu Item。 指定作为菜单项注册该 action 的菜单。在菜单中现有项内的菜单项的位置也可以在此处设置。 

  Global Toolbar Button。 指定作为按钮注册该 action 的工具栏。在工具栏中现有按钮内的工具栏按钮的位置也可以在此处设置。 

 Global Keyboard Shortcut。 指定将调用 action 的键击事件。 

 File Type Context Menu Item。 指定出现菜单项的文件类型的 MIME 类型。现有菜单项中菜单项的位置以及其分隔符也可  以在此处设置。 

  Editor Context Menu Item。 指定出现菜单项的编辑器的 MIME 类型。现有菜单项中菜单项的位置以及其分隔符也可  以在此处设置。

   单击 Next。

4.   在 Name, Icon, and Location 面板中,在 Class Name 中键入 MyFirstAction 并在 Display Name 键入 My First   Action。在 Icon 中,在您的文件系统中浏览 16x16 像素图标。例如,您可以在 NetBeans IDE 5.0 安装目录中的以下位置找到一些 16x16 像素图标:

enterprise2\jakarta-tomcat-5.5.9\server\webapps\admin\images
5.单击 Finish。

IDE 在 org.myorg.myfirstmodule 中创建 MyFirstAction.java 并在 Source Editor 中打开它。这是您应该看到的(单击该链接可以看到相关的 NetBeans API Javadoc):

package org.myorg.myfirstmodule; import org.openide.util.HelpCtx; import org.openide.util.actions.CallableSystemAction; public final class MyFirstAction extends CallableSystemAction { public void performAction() { // TODO implement action body } public String getName() { return "My First Action"; } protected String iconResource() { return "org/myorg/myfirstmodule/Groups.gif"; } public HelpCtx getHelpCtx() { return HelpCtx.DEFAULT_HELP; } protected boolean asynchronous() { return false; } }
正如在 GUI Registration 面板中指定的那样,该 IDE 将在 layer.xml 文件中作为菜单项和工具栏按钮注册 action 类。
<filesystem> <folder name="Actions"> <folder name="Tools"> <file name="org-myorg-myfirstmodule-MyFirstAction.instance"> <attr name="instanceClass" stringvalue="org.myorg.myfirstmodule.MyFirstAction"/> </file> </folder> </folder> <folder name="Menu"> <folder name="Tools"> <attr name="org-openide-actions-ToolsAction.instance /org-myorg-myfirstmodule-MyFirstAction.shadow" boolvalue="true"/> <file name="org-myorg-myfirstmodule-MyFirstAction.shadow"> <attr name="originalFile" stringvalue="Actions/Tools/org-myorg-myfirstmodule-MyFirstAction.instance"/> </file> <attr name="org-myorg-myfirstmodule-MyFirstAction.shadow/Separator1.instance" boolvalue="true"/> </folder> </folder> <folder name="Toolbars"> <folder name="Build"> <attr name="org-netbeans-modules-project-ui-RunMainProject.shadow /org-myorg-myfirstmodule-MyFirstAction.shadow" boolvalue="true"/> <file name="org-myorg-myfirstmodule-MyFirstAction.shadow"> <attr name="originalFile" stringvalue="Actions/Tools/org-myorg-myfirstmodule-MyFirstAction.instance"/> </file> <attr name="org-myorg-myfirstmodule-MyFirstAction.shadow /org-netbeans-modules-project-ui-DebugMainProject.shadow" boolvalue="true"/> </folder> </folder> </filesystem>

6.在 Source Editor 中,按以下形式填写 performAction() 方法:

public void performAction() { String msg = "I'm plugged in!"; NotifyDescriptor d = new NotifyDescriptor.Message(msg, NotifyDescriptor.INFORMATION_MESSAGE); DialogDisplayer.getDefault().notify(d); }

调用 NotifyDescriptor 和 DialogDisplayer 的行带有下划线并标记为错误,类似于以下说明。这是因为相关的包尚未得到声明。下一步将声明这些包。 红色下划线。

7.   在 Projects 窗口中,右键单击 MyFirstOptionCategory 项目节点并选择 Properties。在 Libraries 窗格中,单击 Add。键入 notifyd 并注意返回的列表将缩小,直到显示包含 NotifyDescriptor 的包:

项目属性

单击 OK。将 Dialogs API 添加到 Module Dependencies 列表。单击 OK 确认,并退出 Project Properties 对话框。

8.   在 Source Editor 中,单击 Alt-Shift-F。两个新的导入语句即被添加到源文件的顶部,而且红色下划线消失。这些是新的 import 语句(单击链接可以看到相关的 NetBeans API Javadoc): 

    import org.openide.DialogDisplayer;
    import org.openide.NotifyDescriptor;

插件模块到此结束。接着,您需要安装和使用它。

安装和使用插件模块

IDE 使用 Ant 构建脚本来构建和安装您的插件模块。构建脚本是创建插件模块项目时为您创建的。

安装插件模块

  • 在 Projects 窗口,右键单击 MyFirstModule 项目并在 Target Platform 中选择 Install/Reload。

    插件模块即在目标平台中构建和安装。目标平台在 Tools > NetBeans Platform Manager 中设置。目标平台打开,您可以试用新的插件模块。默认目标 IDE 或平台是由开发 IDE 的当前实例使用的安装平台。

使用 NetBeans 插件模块

1.在新打开的 IDE 菜单栏中,可以看到新的菜单和菜单项,还有您在 Action 向导中指定的图标。

调用您的第一个操作

2.选择该菜单项以调用 MyFirstAction.java 中的 performAction 方法。您应该看到出现 JOptionPane 及当中的信息:

JOption Pane。

3.单击 Toolbar 按钮。它即调用同一 action 而且结果相同。其形式如下:

调用您的第一个操作按钮。

0
相关文章