技术开发 频道

善用开源插件 增强NetBeans开发

  【编者按】NetBeans IDE本身已经非常强大,不过,如果你学会通过那些可满足你需要的插件来对其进行扩展,你会发现该工具用起来会更顺手。Java专家Jeff Friesen在本篇文章中介绍五个开源NetBeans插件,让你可以查看NetBeans文件系统,浏览Windows系统上的图片,检查代码的标准兼容性,为Java类增加属性,以及更轻松的进行OpenGL开发。不过,这只是敲门砖,你可以学会如何创建满足自己需要的NetBeans插件。

  【IT168 技术文档】2008年年初,我使用NetBeans IDE 6.1 with JavaFX来进行编程。在使用这个IDE的过程中,我碰到了插件使用的问题,通过安装这些模块到NetBeans中,可以让该IDE具有新的功能。

  在本篇文章中,我将从众多开源NetBeans插件中选取五个来向大家介绍,从NetBeans插件网站(http://plugins.netbeans.org/PluginPortal/faces/MainPage.jsp)上你都可以免费下载它们。我将介绍每一个插件的用途、它的开源许可类型和它适用的平台。另外,我将简单的介绍一下每个插件在NetBeans IDE 6.5中的使用。最后,我将和大家一起看一下如何创建属于自己的插件,用其来访问NetBeans API Javadoc。

  在看完本篇文章后,你将会了解这五个非常有用的插件。更重要的是,你会熟悉NetBeans的插件架构,而且掌握了自己创建插件的步骤。

  一、File System Displayer:查看NetBeans文件系统

  NetBeans system filesystem是NetBeans配置数据的中心存储器。File System Displayer插件(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14187),由NetBeans专家Geertjan Wielenga开发,可以让你在IDE内浏览NetBeans system filesystem。该插件在通用开发与销售许可(Common Development and Distribution License,CDDL)开源协议下提供,其适用平台包括Solaris、Linux、Mac OS X和Windows。

  在File System Displayer详细信息页面(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=14187)上,点击Download按钮,下载1226158890776_org-demo-fsdisplayer.nbm模块文件。然后启动NetBeans 6.5,通过以下步骤来安装这个插件到IDE中:

  1、从主菜单中选择Tools>Plugins,打开插件对话框。

  2、在该对话框中切换到Downloaded标签。

  3、点击Add Plugins按钮。

  4、在Add Plugins文件选择器中,浏览包含1226158890776_org-demo-fsdisplayer.nbm文件夹,并选中这个文件,然后点击Open按钮。这样File System Displayer插件将会显示在待安装插件列表中。

  5、点击插件对话框的Install按钮。

  6、在出现的NetBeans IDE安装对话框中,点击下一步。你将会看到一个验证警告对话框提示该插件未经签名。点击该对话框中的Continue按钮来忽略这个警告。

  7、安装完成后,点击安装对话框中的Finish按钮,关闭该插件对话框。

  安装完毕后,NetBeans中会出现该插件的FsDisplayer Window浏览窗口组件,它显示了配置数据架构,如图1所示。

  图1、FsDisplayer Window在Projects、Files和Services标签旁边

  运行时,该文件系统由每一个模块基于XML的layer file中的信息组成。每一个layer file定义了被合并到system filesystem中的文件夹和文件。其它模块可以在这些文件夹中存储文件或对象;定义模块可以扫描每一个文件夹的内容,并可以对内容进行想要做的修改。

  

二、PicturesExplorer:在Windows上查看图片

  Kunal Modi的PicturesExplorer插件(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=5895),可以让Windows XP用户在NetBeans内查看“我的图片”文件夹中的内容;无需离开该IDE就可打开一个图片查看器。该插件在GPLv2下提供。

  点击PictureExplorer详细信息页面(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=5895)中的Download按钮,下载PictureExplorer的1202697173670_org-modules-sack-picturesexplorer.nbm模块文件。然后通过上面的步骤来安装该插件。安装完成后,从Window菜单中选择Pictures来显示包含“我的图片”内容的Pictures窗口。

  你可以对当前显示的图片进行放大缩小操作,如图2所示。

  图2、缩放图片

  通过其它按钮,你可以恢复该图片到其原始尺寸,也可以通过预先定义好的比例来缩放图片,或者按照自己设定的比例来进行图片缩放。

  三、Checkstyle 4.3插件:检查代码的标准兼容性

  Checkstyle(http://www.javaworld.com/javaworld/jw-11-2008/jw-11-checkstyle1.html)可以帮助你编写遵循指定编程标准的Java源代码。该工具可自动完成检查代码标准兼容性的任务。通过Andrea Matsunaga的Checkstyle 4.3插件(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=4552),可以让NetBeans具有Checkstyle的功能,该插件在GPLv2下提供,适用平台包括Solaris、Linux、Mac OS X和Windows。

  点击Checkstyle 4.3详细信息页面(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=4552)中的Download按钮,下载42267_com-ammatsun-checkstyle4nb-4.3.1.nbm模块文件,然后通过上述步骤安装该插件。安装完成后,选择打开任意Java源代码文件,然后点击Checkstyle图标(主工具栏最右边的图标)来对该代码进行检查,如图3所示。

  图3、点击Checkstyle图标检查当前Java源代码文件

  Checkstyle默认按照Sun的Java代码约定来检查代码,不过,你可以让它支持不同的编码标准,方法是:选择Tools>Options,然后从Options对话框的Checkstyle标签页中,选择合适的Checkstyle配置和属性文件。如果你希望了解如何在Checkstyle中开发新的编码标准,需要查看Checkstyle的文档。

  四、Add Property:为Java类增加属性

  许多开发者希望Java SE 7可以引入新的语言功能,其中一个希望增加的功能就是properties。如果你在Google中搜索“java 7 property”,你将会发现该话题已经被人们所广泛讨论,关于其语法形式的观点到处皆是。我们在继续等待Java SE 7的属性支持的同时,可以先来看一下Sandip V. Chitale的Add Property插件。

  Add Property在CDDL许可下提供,其适用平台包括Solaris、Linux、Mac OS X和Windows。它使得向Java类增加属性非常简单。

  访问该插件的详细信息页面(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=3973),点击Download按钮,下载1198476035439_org-netbeans-modules-java-addproperty.nbm模块文件,然后安装该插件。

  现在我们就可以开始使用该插件了。启动新建项目向导,创建一个名为Employee的Java应用程序项目。设定该项目的package为employee,其主类为Main。其框架代码与图3所示类似。

  接下来,我们需要引入一个name属性来表示员工的姓名。选择Source>Add Property,然后在弹出的Add Property对话框的Name字段中指定名称。图4所示对话框显示了所产生的属性代码。

  图4、String的默认属性类型

  点击OK,在插入符位置插入代码。如果插入符位置不在一个类内,会导致代码不能编译。在这种情况下,你需要通过Edit>Undo来取消插入操作,然后重新设定插入符的位置,再次启动Add Property对话框,点击OK按钮。这个对话框会记住此前的设置。

  Add Property让你可以进行广泛的定制操作。举例来说,你可以创建一个bound属性。如果你需要进行一个它所不支持的特殊定制,你需要对样本文件模板进行修改。按照以下步骤访问这个模板:

  1、选择Tools>Templates。

  2、在弹出的模板管理器对话框中,选择并展开org.netbeans.modules.java.addproperty模板种类文件夹。

  3、在该文件夹下选择AddProperty.freemarker模板,然后点击打开按钮。

  图5显示了该模板的一部分。

  图5、包含特定${identifier}占位符和类似HTML的<#if>块标记的模板

  从图5中可以看出,该模板中包含了不同的${identifier}占位符,其中identifier命名了一个特殊变量。每一个占位符的值被插入到生成代码中。例如,图4对话框中Type文本框中的String值将通过${type}占位符插入到生成代码中。

  图5中还有不同的<#if identifier>标签,其中identifier命名了一个特定变量。变量值为布尔表达式,来决定<#if identifier>和之间的代码是否被插入到生成代码中。例如,如果static选框被选中,<#if static >static 就会插入static到生成代码中。

  尽管图5所示模板非常易于理解,通过以下几个复杂的例子可以加深你的理解:

  ·${access}插入选定的private、protected或public单选按钮的名称到生成代码中。如果package被选中,则不执行任何插入操作。

  ·当Generate Javadoc选框被点击时,以下示例将插入Javadoc到生成代码中。在Javadoc内的两次出现${name},实现了对属性名称的扩展。

  <#if generateJavadoc >

  
/**

  
* Get the value of ${name}

  
*

  
* @return the value of ${name}

  
*/

   ·return <#if !static >this.${name};如果static选框未被选中,插入this.前缀,后面跟着属性的名称和一个分号,到生成代码中。

  五、NetBeans OpenGL Pack:简化OpenGL开发

  Michael Bien为我们带来了NetBeans OpenGL Pack(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=3260),让我们可以在NetBeans内可以实现一个易用的OpenGL开发环境。这个插件提供了几个模块,诸如OpenGL Shading Language(GLSL)阴影编辑器和OpenGL性能查看器,它还包含JOGL演示和来自OpenGL编程指南的所有OpenGL示例。NetBeans OpenGL Pack在GPLv2授权下提供,其适用平台包括Solaris、Linux、Mac OS X和Windows。

  点击NetBeans OpenGL Pack详细信息页面(http://plugins.netbeans.org/PluginPortal/faces/PluginDetailPage.jsp?pluginid=3260)中的Download按钮,下载NetBeans OpenGL Pack的227048417356_netbeans-opengl-pack_0.5.3.zip压缩文件。解压缩后,你将会发现几个NBM文件。在安装它们之前,你必须选择所有需要安装的模块,如图6所示。

  图6、点击安装按钮开始安装选定模块

  安装完NetBeans OpenGL Pack后,你可以立即在NetBeans中尝试运行OpenGL演示程序。例如,启动新建项目向导,并展开OpenGL分类目录(如图7所示),选择演示程序子目录,然后选择JOGL Hardware Shadow Mapping演示项目。

  图7、选择JOGL演示

  点击下一步,然后点击完成,NetBeans会基于所选的演示创建一个新项目。如图8所示,你可以查看并编辑该演示的源代码,编译并运行该演示。

  图8、在NetBeans中可以轻松编辑、编译和运行JOGL演示

  六、推出你自己的插件

  在体验了上述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实现操作部分。

try
{
    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开发效率。本篇文章我简单介绍的几个插件只是其中很少的一部分。当然,如果你找不到一个可以满足你需要的插件,我希望本篇文章也可以让你动手去自己创建一个。

0
相关文章