NetBeans DataLoader 模块教程
反馈
本教程向您介绍如何编写让 IDE 识别新文件类型的模块。在 IDE 中识别的文件类型具有它自己的图标、菜单项和行为。所显示的“文件”是 FileObjects—用 java.io.File 包装,如果是配置文件,则通常用其他方式存储的数据包装,如模块中的 XML 文件。您实际看到 的是 Nodes,它提供和操作一样的功能以及和文件一样的对象的本地化名称。在 Nodes 和 FileObjects 之间是 DataObjects。DataObject 和 FileObject 相同,不过前者知道将显示的文件种类,对于不同扩展名的文件和不同名称空间的 XML 文件,通常有不同类型的 DataObject。每个 DataObject 都由不同模块提供,每个都支持一个或多个文件类型,例如,Image 模块可以识别和打开 .gif 和 .png 文件。
识别文件类型的模块安装 DataLoader,即特定文件类型 DataObject 的工厂。当展开文件夹时,IDE 询问每个已知的 DataLoader“Do you know what this is?”第一个回答“Yes”的 DataLoader 会为该文件创建 DataObject。为了实际显示每个文件的内容,系统对在 IDE 中实际看到的每个 DataObject 和 Nodes 调用 DataObject.getNodeDelegate()。
下面左侧的图表显示上面提到的每个可用项目;右侧的图表显示它们之间的关系:
本教程中,您将创建为 JAR manifest 文件(.mf 扩展名)安装 DataLoader 的模块。默认情况下,将 manifest 文件作为 IDE 无法识别的任何其他文件处理(将其视为文本文件),因此,IDE 为 manifest 文件提供和文本文件相同的功能。创建该模块之后,您将看到如何使用仅用于 manifest 文件的功能来改善该模块。完成开发周期时,您可以轻松地让其他人使用您的模块,IDE 允许您创建一个二进制文件并将其发送给他人,然后其他人可以通过 Update Center 安装该文件。
本教程将介绍以下主题:
安装完软件之后,本教程可以在 30 分钟之内完成。
有关使用 NetBeans 模块的详细信息,请参阅 NetBeans 网站上的 NetBeans Development Project 主页。如果有问题,请访问 NetBeans Developer FAQ 或使用本页顶部的反馈链接。
安装软件
开始之前,需要在您的计算机上安装以下软件:
- NetBeans IDE 5.0(下载)
- Java Standard Development Kit (JDK™) version 1.4.2(下载)或 5.0(下载)
安装示例
采用以下步骤来安装示例:
- 解压缩附加的文件。
- 在 IDE 中,选择 File > Open Project,然后浏览到包含已解压缩文件的文件夹。打开模块项目。其形式如下:
- 右键单击项目节点并在 Target Platform 中选择 Install/Reload。将打开目标平台并安装该模块。
- 使用 New Project 向导 (Ctrl-Shift-N) 创建 Java 应用程序,注意它的 manifest 文件具有不同的图标,而且它的弹出菜单具有新项目。选择弹出菜单项并观察结果。
创建模块项目
- 选择 File > New Project (Ctrl-Shift-N)。在 Categories 下,选择 NetBeans Plug-in Modules。在 Projects 下,选择 Module Project 并单击 Next。
- 在 Name and Location 面板中,在 Project Name 中键入 ManifestFileType。将 Project Location 更改为您计算机上的任何目录,如 c:\mymodules。选中 Standalone Module 单选按钮。该面板应该如下所示:
单击 Next。
- 在 Basic Module Configuration 面板中,用 myorg 替换 Code Name Base 中的 yourorghere,从而整个代码的 Code Name Base 为 org.myorg.manifestfiletype。向默认的 Module Display Name 中添加空格,将它更改为 Manifest File Type。留下本地化包和 XML 层的位置,以便它们存储在名为 org/myorg/manifestfiletype 的包中。该面板应该如下所示:
- 单击 Finish。
IDE 创建 Manifest File Type 项目。该项目包含所有资源和项目元数据,如该项目的 Ant 构建脚本。该项目在 IDE 中打开。您可以在 Projects 窗口 (Ctrl-1) 中查看其逻辑结构,在 Files 窗口 (Ctrl-2) 中查看其文件结构。例如,现在 Projects 窗口应该如下所示:
有关以上每个文件的基本信息,请参阅 NetBeans 插件模块的快速入门指南。
识别 Manifest 文件
- 右键单击项目节点并选择 New > File Type。单击 Next。
- 在 File Recognition 面板中,执行以下操作:
- 在 MIME Type 编辑框中,键入 text/x-java-jar-manifest。
- 在 by Filename Extension 编辑框中,键入 .mf .MF。
File Recognition 面板应该如下所示:
注意以下关于 File Recognition 面板中各字段的内容:
- MIME Type。 指定数据对象的唯一 MIME 类型。
- by
单击 Next。
- 在 Name and Location 面板中,键入 Manifest 作为 Class Name Prefix,并浏览到作为新文件类型图标的任何 16x16 像素的图像文件,如下所示。
注意到在 NetBeans 安装目录中发现了几个 16x16 像素图像文件,例如,在以下位置:
enterprise2\jakarta-tomcat-5.5.7\server\webapps\admin\images.
对于本教程,只使用上面目录中的 Datasource.gif 图像。其形式如下:
- 单击 Finish。
现在 Projects 窗口应该显示如下:

下面简要介绍每个新生成的文件:
- ManifestDataLoader.java。 识别 text/x-java-jar-manifest MIME 类型。作为 ManifestDataObject.java 的工厂。有关详细信息,请参阅 What is a DataLoader?。
- ManifestResolver.xml。 将 .mf 和 .MF 扩展名映射到 MIME 类型。ManifestDataLoader 只识别 MIME 类型;它不知道有关文件扩展名的信息。
- ManifestDataObject.java。 包装 FileObject。DataObjects 由 DataLoaders 生成。有关详细信息,请参阅 What is a DataObject?。
- ManifestDataNode.java。 提供在 IDE 中看到 的内容,如操作、图标和本地化的名称等功能。
- ManifestDataLoaderBeanInfo.java。 控制 Options 窗口的 Object Types 部分中加载程序的出现。