六、推出你自己的插件
在体验了上述NetBeans插件后,你可能希望创建满足自己需要的特定插件。如果你是一个新手,可能会觉得有些难度,不过幸运的是,NetBeans大大简化了插件开发。
下面我将通过一个简单的例子来对此进行说明。在该示例中,在你选择一个菜单条目时,该插件将启动一个Web浏览器,并显示NetBeans APIDoc文档的起始页。当你准备创建一个充分利用不同NetBeans APIDoc的复杂插件时,快速访问这个文档是非常有帮助的。
图9、选择Helper>Show NetBeans API Documentation来快速访问NetBeans APIDoc Javadoc
为了创建这个插件,你首先需要创建并配置一个新NetBeans项目:
1、启动NetBeans IDE 6.5。
2、选择File>New Project,启动新建项目对话框。
3、在该对话框的Choose Project面板上,从Categories列表中选择NetBeans Modules,从Projects列表中选择Module。点击下一步。
4、在之后的名称和位置面板上,输入NetBeansAPIDoc作为项目名称,记得一定要选上Standalone Module单选按钮。然后点击下一步。
5、在最后的Basic Module Configuration面板上,在代码基(Code Name Base)文本框中输入org.myorg.netbeansapidoc。选中Generate XML Layer选框,然后点击完成按钮。
接下来,你需要创建一个操作来启动Web浏览器,并通过菜单条目来调用该操作:
1、在项目窗口中,右键点击NetBeansAPIDoc项目名称。
2、在弹出菜单中,选择New>Action。这将启动新的Action对话框。
3、在该对话框的操作类型面板上,选中Always Enabled单选按钮,然后点击下一步。
4、在接下来的GUI Registration面板中:
·在Category下拉列表中选择Help类。
·选中Global Menu Item选框。
·在Menu下拉列表中选择Helper作为菜单。
·在Position下拉列表中选择“Javadoc References - HERE -
·去掉Global Toolbar Button和Global Keyboard Shortcut选框的勾选。
·点击下一步。
5、在最后的Names、Icon和Location面板中,在CLASS Name文本字段输入ShowNetBeansAPIDoc,在Display Name 文本字段输入Show NetBeans API Documentation,然后点击Finish按钮。同时,NetBeans创建一个ShowNetBeansAPIDoc.java源代码文件,其主要内容在一个新标签页中显示,如图10所示。
图10、当选择Show NetBeans API Documentation菜单条时,会调用actionPerformed()方法。
最后,你需要告诉actionPerformed()方法启动浏览器,并让其显示NetBeans APIDoc文档起始页。使用如下代码段替换//TODO实现操作部分。
{
URLDisplayer.getDefault()
.showURL(new URL("http://bits.netbeans.org/dev/javadoc/"));
}
catch (Exception ex)
{
return;
}
完成替换后,你会发现NetBeans不能发现URLDisplayer和URL类。它会通过在相关类名称下显示红色波纹线的形式来报告这个问题。通过以下几步来改正这个问题:
1、在Projects窗口中,右键点击NetBeansAPIDoc。
2、从弹出菜单中选择Properties菜单条,启动项目属性对话框。
3、从Categories列表中选择Libraries。
4、点击与Module Depencies列表相关的Add按钮,启动Add Module Dependency对话框。
5、在Filter文本框中,输入URLDisplayer。点击OK按钮。
6、点击OK关闭项目属性。
7、右键点击ShowNetBeansAPIDoc.java中的任意地方,从弹出菜单中选择Fix Imports,启动Fix All Imports对话框。
8、点击OK。该IDE将把import java.net.URL;和import org.openide.awt.HtmlBrowser.URLDisplayer;声明加入到ShowNetBeansAPIDoc.java中。
通过创建一个NBM文件,你可以与其它开发者分享一个插件。例如,你可以创建一个org-myorg-netbeansapidoc.nbm文件来发送该插件给自己的朋友,方法是:右键点击NetBeansAPIDoc项目名称,从弹出菜单中选择Create NBM。在我的Windows XP平台上,org-myorg-netbeansapidoc.nbm文件被保存在C:\Documents and Settings\Jeff Friesen\My Documents\NetBeansProjects\NetBeansAPIDoc\build目录下。
结论
通过充分利用NetBeans Plugin Portal网站上提供的插件,我们可以大大提高NetBeans开发效率。本篇文章我简单介绍的几个插件只是其中很少的一部分。当然,如果你找不到一个可以满足你需要的插件,我希望本篇文章也可以让你动手去自己创建一个。