| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> | |
| <html xmlns="http://www.w3.org/1999/xhtml"> | |
| <head> | |
| <!-- -*- xhtml -*- --> | |
| <title>针对 NetBeans 平�?� 6.5 的文件类型集�?教程</title> | |
| <link rel="stylesheet" type="text/css" href="https://netbeans.org/netbeans.css"> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
| <meta name="AUDIENCE" content="NBUSER"> | |
| <meta name="TYPE" content="ARTICLE"> | |
| <meta name="EXPIRES" content="N"> | |
| <meta name="developer" content="gwielenga@netbeans.org"> | |
| <meta name="indexed" content="y"> | |
| <meta name="description" | |
| content="A short guide to using the Nodes API."> | |
| <!-- Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved. --> | |
| <!-- Use is subject to license terms.--> | |
| </head> | |
| <body> | |
| <h1>文件类型集�?教程</h1> | |
| <p>本教程将�?�您演示如何编写一个模�?�，以便使 IDE 或构建于 NetBeans 平�?�之上的任何其他应用程�?能够识别新的文件类型。 | |
| <p><b class="notes">注�?：</b>本文档针对的是 NetBeans IDE 6.5 �?�行版。如果使用的是 NetBeans IDE 6.x，请�?��?<a href="60/nbm-filetype_zh_CN.html">本文档的 6.1 版</a>。 | |
| <p><b>目录</b></p> | |
| <img src="../images/articles/68/netbeans-stamp-65-67-68.gif" class="stamp" width="114" height="114" alt="本页上的内容适用于 NetBeans IDE 6.5�?6.7�?6.8" title="本页上的内容适用于 NetBeans IDE 6.5�?6.7�?6.8"> </p> | |
| <ul class="toc"> | |
| <li><a href="#intro">文件类型集�?简介</a></li> | |
| <li><a href="#creating">创建模�?�项目</a></li> | |
| <li><a href="#recognizing">识别 Abc 文件</a></li> | |
| <li><a href="#install">安装和试用功能</a></li> | |
| <li><a href="#adding">为 Abc 文件创建功能</a></li> | |
| <ul> | |
| <li><a href="#action">添加�?作</a> | |
| <li><a href="#topcomponent">在窗�?�中打开文件</a> | |
| <li><a href="#multiview">创建多视图窗�?�</a> | |
| </ul> | |
| <li><a href="#share">创建�?�共享的二进制文件</a></li> | |
| </ul> | |
| <p><b>�?学习本教程，您需�?具备下表中列出的软件和资�?。</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">软件或资�?</th> | |
| <th class="tblheader" scope="col">�?求的版本</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">NetBeans IDE</a></td> | |
| <td class="tbltd1">6.5 或更高版本</td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="http://java.sun.com/javase/downloads/index.jsp">Java Developer Kit (JDK)</a></td> | |
| <td class="tbltd1">版本 6 或<br/>版本 5</td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <h2 class="tutorial"><a name="intro"></a>文件类型集�?简介</h2> | |
| <p>在 IDE 中�?�识别的文件类型有它们自己的图标�?�?��?�项以�?�行为。所显示的“文件�?是 <tt>FileObject</tt>，�?� <tt>java.io.File</tt> 的包装器；对于�?置文件，则为以�?�?其他方�?存储（例如存储在模�?�的 XML 文件内）的数�?�的包装器。您实际<i>看到</i>的是 <tt>Node</tt>，它们�?�诸如文件之类的对象�??供�?作和本地化�??称等功能。�?于 <tt>Node</tt> 和 <tt>FileObject</tt> 之间的是 <tt>DataObject</tt>。<tt>DataObject</tt> 与 <tt>FileObject</tt> 类似，�?�?�之处在于它了解显示的是哪�?类型的文件，并且对于具有�?�?�扩展�??的文件以�?�具有�?�?��??称空间的 XML 文件，通常存在�?�?�类型的 <tt>DataObject</tt>。�?个 <tt>DataObject</tt> 都是由一个�?�?�的模�?��??供的，�?个模�?�支�?一�?或多�?文件类型，例如，通过图�?模�?��?�以识别和打开 <tt>.gif</tt> 和 <tt>.png</tt> 文件。 | |
| <p>用于识别文件类型的模�?�会安装一个 <tt>DataLoader</tt>，这是特定于文件类型的 <tt>DataObject</tt> 工厂。当展开�?个文件夹时，IDE 会询问�?个已知的 <tt>DataLoader</tt> 是�?�了解此文件夹的内容。第一个回答“是�?的 DataLoader 将为其中的文件创建 <tt>DataObject</tt>。为了实际显示�?个文件的�?些内容，系统会对�?个 <tt>DataObject</tt> 调用 <tt>DataObject.getNodeDelegate()</tt>，而 <tt>Node</tt> 便是您在 IDE 中实际看到的内容。 | |
| <p>下图（居左）显示了上�?��??到的�?一项所�??供的内容： | |
| <p><p align="left"><img src="../images/tutorials/filetype/diagram-dataobject2.png" alt="图。"> | |
| <p>在本教程中，您将创建一个模�?�，用于为�?�定的 "Abc" 文件（扩展�??为 <tt>.abc</tt>）安装 <tt>DataLoader</tt>。缺�?情况下，扩展�??为 "abc" 的文件会被视为 IDE 无法识别的任何其他文件；在本教程中，我们将其视为文本文件，因此，IDE 应为 Abc 文件�??供与文本文件相�?�的功能。创建此模�?��?�，我们将�?�您演示如何用仅供 Abc 文件使用的功能�?�增强此模�?�。开�?�周期完�?�?�，您�?�以通过以下方法轻�?�地让其他人使用您的模�?�：在 IDE 中创建一个二进制文件并将此文件�?��?给其他人，�?�者�?�以通过更新中心�?�安装此文件。 | |
| <!-- ===================================================================================== --> | |
| <h2 class="tutorial"><a name="creating"></a>创建模�?�项目</h2> | |
| <p>在本节中，我们将利用�?�导创建�?个 NetBeans 模�?�所需的�?代�?结构。�?代�?结构包�?��?于特定�?置的�?些文件夹以�?�一组始终需�?的文件。例如，�?个 NetBeans 模�?�都需�?一个 <tt>nbproject</tt> 文件夹和一个 <tt>layer.xml</tt> 文件，�?者用于存放项目的 meta 数�?�，�?�者用于工具�?按钮和窗�?�等项的声明性注册。 | |
| <ol> | |
| <li>选择“文件�?>“新建项目�?(Ctrl-Shift-N)。在“类别�?下选择“NetBeans 模�?��?。在“项目�?下选择“模�?��?，然�?��?�击“下一步�?。</li> | |
| <li>在“�??称和�?置�?�?��?�的“项目�??称�?中键入 <tt>AbcFileType</tt>。将项目�?置更改为计算机上的任�?目录，例如 <tt>c:\mymodules</tt>。将“独立模�?��?�?�选按钮�?留为选中状�?。此�?��?�现在应如下所示： | |
| <p><p align="left"><img src="../images/tutorials/filetype/65-projectwizard1.png" alt="“新建项目�?�?�导的第 1 步。"> | |
| <p>�?�击“下一步�?。 | |
| <li>在“基本模�?��?置�?�?��?�的“代�?�??称基�?中键入 <tt>org.myorg.abcfiletype</tt>。在建议的模�?�显示�??称中添加空格，以将其更改为 <tt>Abc File Type</tt>。选中“生�? XML 层�?�?选框并�?留本地化包和 XML 层的�?置，以将其存储在�??为 <tt>org/myorg/abcfiletype</tt> 的包中。此�?��?�现在应如下所示： | |
| <p><p align="left"><img src="../images/tutorials/filetype/65-projectwizard2.png" alt="“新建项目�?�?�导的第 2 步。"> | |
| <li>�?�击“完�?�?。</ol> | |
| <p> IDE 将创建 <tt>Abc File Type</tt> 项目。此项目包�?�所有�?代�?和项目 meta 数�?�，例如项目的 Ant 生�?脚本。此项目将会在 IDE 中打开。您�?�以在“项目�?窗�?� (Ctrl-1) 中查看其逻辑结构，在“文件�?窗�?� (Ctrl-2) 中查看其文件结构。例如，“项目�?窗�?�现在应如下所示： | |
| <p><p align="left"><img src="../images/tutorials/filetype/65-projectswindow1.png" alt="最�?的“项目�?窗�?�。"> | |
| <br /> | |
| <!-- ===================================================================================== --> | |
| <h2><a name="recognizing"></a>识别 Abc 文件</h2> | |
| <p>在本节中，我们将利用�?�导创建区分 Abc 文件和所有其他文件所需的类。在本教程的开头已�??到，�?实现此目的，我们需�?一个数�?�对象�?一个数�?�加载器�?一个 MIME 类型解�?器以�?� <tt>layer.xml</tt> 文件中的注册�?�目。“新建文件类型�?�?�导将自动为我们创建所有这些内容。 | |
| <ol> | |
| <li>�?�键�?�击项目节点，然�?�选择“新建�?>“文件类型�?。</li> | |
| <li>在“文件识别�?�?��?�中，执行以下�?作： | |
| <p><ul><li>在“MIME 类型�?编辑框中键入 <tt>text/x-abc</tt>。 | |
| <li>在“按文件扩展�??�?编辑框中键入 <tt>.abc .ABC</tt>。</ul> | |
| <p>“文件识别�?�?��?�现在应如下所示： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-filewizard1.png" alt="“新建文件�?�?�导的第 1 步。"> | |
| <p>请注�?下�?��??供的有关“文件识别�?�?��?�中的字段的说明： | |
| <ul> | |
| <li><b>MIME 类型。</b>指定数�?�对象的唯一 MIME 类型。 | |
| <li>按 | |
| <ul><li><b>文件扩展�??。</b>指定一个或多个文件扩展�??，IDE 将这些扩展�??识别为属于指定的 MIME 类型。�?�以选择在文件扩展�??�?�?�加一个圆点。分隔符为逗�?�和/或空格。因此，所有以下内容都是有效的： | |
| <p><ul><li><tt>.abc,.def</tt> | |
| <li><tt>.abc .def</tt> | |
| <li><tt>abc def</tt> | |
| <li><tt>abc,.def ghi, .wow</tt></ul> | |
| <p>我们�?�定 Abc 文件区分大�?写。为此，在本教程中指定了<i>两�?</i> MIME 类型：<tt>.abc</tt> 和 <tt>.ABC</tt>。 | |
| <li><b>XML 根元素。</b>指定唯一的�??称空间，以将该 XML 文件类型与所有其他 XML 文件类型区分开。由于许多 XML 文件具有相�?�的扩展�?? (<tt>xml</tt>)，因此 IDE 通过 XML 根元素�?�区分�?�个 XML 文件。更确切地说，就是 IDE �?�以区分�??称空间以�?� XML 文件中的第一个 XML 元素。例如，您�?�以利用这一点�?�区分 JBoss 部署�??述符和 WebLogic 部署�??述符。区分开这两�?部署�??述符�?�，便�?�以确�?添加到 JBoss 部署�??述符上下文�?��?�中的�?��?�项对于 WebLogic 部署�??述符�?�?�用。有关示例，请�?��? <a href="nbm-palette-api2.html">NetBeans 组件�?��?�模�?�教程</a>。 | |
| </ul></ul> | |
| <p>�?�击“下一步�?。 | |
| <li>在“�??称和�?置�?�?��?�的“类�??�?缀�?中键入 <tt>Abc</tt>，然�?��?览到任�? 16x16 �?素的图�?文件作为新文件类型的图标，如下所示。 | |
| <p align="left"><p><p align="left"><img src="../images/tutorials/filetype/65-filewizard2.png" alt="“新建文件�?�?�导的第 2 步。"> | |
| <p><b>注�?：</b>您�?�以使用尺寸为 16x16 �?素的任�?图标。如果愿�?，�?�以�?�击以下图标并将其�?存在本地，然�?�在上�?�的�?�导步骤中指定该图标：<img src="../images/tutorials/filetype/Datasource.gif" alt="Datasource.gif"> | |
| <li>�?�击“完�?�?。 | |
| <p><p>“项目�?窗�?�现在应如下所示： | |
| <p><p align="left"><img src="../images/tutorials/filetype/65-projectswindow2.png" alt="最终的“项目�?窗�?�。"></ol> | |
| <p>下�?�简�?介�?了�?个新生�?的文件： | |
| <ul> | |
| <li><b>AbcDataObject.java。</b>包装 <tt>FileObject</tt>。DataObject 是由 DataLoader 生�?的。有关详细信�?�，请�?��? <a href="http://wiki.netbeans.org/wiki/view/DevFaqDataObject">What is a DataObject?</a>（什么是 DataObject？）。 | |
| <li><b>AbcResolver.xml。</b>将 <tt>.abc</tt> 和 <tt>.ABC</tt> 扩展�??映射到 MIME 类型。<tt>AbcDataLoader</tt> 仅识别 MIME 类型，而�?了解有关文件扩展�??的信�?�。 | |
| <li><b>AbcTemplate.abc。</b>为 <tt>layer.xml</tt> 中注册的文件模�?��??供了基础，以便将其作为新模�?�安装在“新建文件�?对�?框中。 | |
| <li><b>AbcDataObjectTest.java。</b><tt>DataObject</tt> 的 JUnit 测试类。 | |
| </ul> | |
| </p> | |
| <p>在 <tt>layer.xml</tt> 文件中，将会看到以下内容： | |
| <pre><folder name="Loaders"> | |
| <folder name="text"> | |
| <folder name="x-abc"> | |
| <folder name="Actions"> | |
| <file name="org-myorg-abcfiletype-MyAction.shadow"> | |
| <attr name="originalFile" stringvalue="Actions/Edit/org-myorg-abcfiletype-MyAction.instance"/> | |
| <attr name="position" intvalue="600"/> | |
| </file> | |
| <file name="org-openide-actions-CopyAction.instance"> | |
| <attr name="position" intvalue="100"/> | |
| </file> | |
| <file name="org-openide-actions-CutAction.instance"> | |
| <attr name="position" intvalue="200"/> | |
| </file> | |
| <file name="org-openide-actions-DeleteAction.instance"> | |
| <attr name="position" intvalue="300"/> | |
| </file> | |
| <file name="org-openide-actions-FileSystemAction.instance"> | |
| <attr name="position" intvalue="400"/> | |
| </file> | |
| <file name="org-openide-actions-OpenAction.instance"> | |
| <attr name="position" intvalue="500"/> | |
| </file> | |
| <file name="org-openide-actions-PropertiesAction.instance"> | |
| <attr name="position" intvalue="700"/> | |
| </file> | |
| <file name="org-openide-actions-RenameAction.instance"> | |
| <attr name="position" intvalue="800"/> | |
| </file> | |
| <file name="org-openide-actions-SaveAsTemplateAction.instance"> | |
| <attr name="position" intvalue="900"/> | |
| </file> | |
| <file name="org-openide-actions-ToolsAction.instance"> | |
| <attr name="position" intvalue="1000"/> | |
| </file> | |
| <file name="sep-1.instance"> | |
| <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/> | |
| <attr name="position" intvalue="1100"/> | |
| </file> | |
| <file name="sep-2.instance"> | |
| <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/> | |
| <attr name="position" intvalue="1200"/> | |
| </file> | |
| <file name="sep-3.instance"> | |
| <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/> | |
| <attr name="position" intvalue="1300"/> | |
| </file> | |
| <file name="sep-4.instance"> | |
| <attr name="instanceClass" stringvalue="javax.swing.JSeparator"/> | |
| <attr name="position" intvalue="1400"/> | |
| </file> | |
| </folder> | |
| <folder name="Factories"> | |
| <file name="AbcDataLoader.instance"> | |
| <attr name="SystemFileSystem.icon" urlvalue="nbresloc:/org/myorg/abcfiletype/Datasource.gif"/> | |
| <attr name="dataObjectClass" stringvalue="org.myorg.abcfiletype.AbcDataObject"/> | |
| <attr name="instanceCreate" methodvalue="org.openide.loaders.DataLoaderPool.factory"/> | |
| <attr name="mimeType" stringvalue="text/x-abc"/> | |
| </file> | |
| </folder> | |
| </folder> | |
| </folder> | |
| </folder></pre> | |
| <br /> | |
| <!-- ======================================================================================= --> | |
| <h2><a name="install"></a>安装和试用功能</h2> | |
| <p>现在，让我们安装该模�?�，然�?�使用此�?创建的基本功能。IDE 使用 Ant 生�?脚本�?�生�?和安装模�?�。此生�?脚本是在创建项目时创建的。</p> | |
| <div class="indent"> | |
| <ol> | |
| <li>在“项目�?窗�?�中，�?�键�?�击 "Abc File Type"<tt></tt> 项目，然�?�选择“�?行�?。 | |
| <p><p>将�?�动一个新的 IDE 实例，�?�时该实例将�?�其自身安装您的模�?�。 | |
| <li>使用“新建项目�?对�?框 (Ctrl-Shift-N) 在 IDE 中创建任�?类型的应用程�?。 | |
| <li>�?�键�?�击该应用程�?节点，然�?�选择“新建�?>“其他�?。在“其他�?类别中，有一个用于创建新文件类型的模�?�： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-action4.png" alt="虚拟模�?�。"></p> | |
| <p>完�?�?�导�?�，您便创建了一个�?�用于帮助用户创建给定文件类型的模�?�。</p> | |
| <p class="tips">如果�?通过该模�?��??供缺�?代�?，请将这些代�?添加到“新建文件类型�?�?�导所创建的 <tt>AbcTemplate.abc</tt> 文件中。 | |
| </ol> | |
| </div> | |
| <br /> | |
| <!-- ===================================================================================== --> | |
| <h2><a name="adding"></a>为 Abc 文件创建功能</h2> | |
| <p>现在 NetBeans 平�?�能够将 Abc 文件与所有其他类型的文件区分开，接下�?�应添加特定于该文件类型的功能。在本节中，我们将在从资�?管�?�器窗�?�（例如，“项目�?窗�?�）�?�键�?�击该文件节点所显示的上下文�?��?�中添加一个�?��?�项，并使该文件能够在一个窗�?�中打开，而�?是在编辑器中打开。 | |
| <div class="indent"> | |
| <h3 class="tutorial"><a name="action"></a>添加�?作</h3> | |
| <p>在本�?节中，我们将使用“新建�?作�?�?�导创建一个 Java 类，用于为我们的文件类型执行�?作。此�?�导还将在 <tt>layer.xml</tt> 文件中注册该类，以使用户能够在从资�?管�?�器窗�?��?�键�?�击该文件类型节点所显示的上下文�?��?�中调用此�?作。 | |
| <ol> | |
| <li>�?�键�?�击项目节点，然�?�选择“新建�?>“�?作�?。</li> | |
| <li>在“�?作类型�?�?��?�中，�?�击“有�?�件地�?�用�?。键入 <tt>AbcDataObject</tt>，这是之�?由“新建文件类型�?�?�导生�?的数�?�对象的�??称，如下所示： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-action1.png" alt="“新建�?作�?�?�导的第 1 步。"> | |
| <p>�?�击“下一步�?。 | |
| <li>在“GUI 注册�?�?��?�中，从“类别�?下拉列表中选择“编辑�?类别。“类别�?下拉列表用于控制�?作在 IDE 的快�?�键编辑器中的显示�?置。 | |
| <p><p>接下�?�，�?�消选中“全局�?��?�项�?，然�?�选中“文件类型上下文�?��?�项�?。在“内容类型�?下拉列表中，选择您之�?在“新建文件类型�?�?�导中指定的 MIME 类型，如下所示： | |
| <p align="left"><p><p align="left"><img border="1" src="../images/tutorials/filetype/60-action2.png" alt="“新建�?作�?�?�导的第 2 步。"> | |
| <p>请注�?，您�?�以设置�?��?�项的�?置，并将此�?��?�项与其�?�?�和�?��?�的�?��?�项隔开。�?�击“下一步�?。 | |
| <li>在“�??称和�?置�?�?��?�的“类�??�?中键入 <tt>MyAction</tt>，在“显示�??称�?中键入 <tt>My Action</tt>。上下文�?��?��??供的�?��?�项�?显示图标。因此，请�?�击“完�?�?，此时 <tt>MyAction.java</tt> 将被添加到 <tt>org.myorg.abcfiletype</tt> 包中。 | |
| <li>在�?代�?编辑器中，将下�?�的代�?添加到此�?作的 <tt>performAction</tt> 方法中： | |
| <pre class="examplecode">protected void performAction(Node[] activatedNodes) { | |
| AbcDataObject abcDataObject = activatedNodes[0].getLookup().lookup(AbcDataObject.class); | |
| FileObject f = abcDataObject.getPrimaryFile(); | |
| String displayName = FileUtil.getFileDisplayName(f); | |
| String msg = "I am " + displayName + ". Hear me roar!"; | |
| NotifyDescriptor nd = new NotifyDescriptor.Message(msg); | |
| DialogDisplayer.getDefault().notify(nd); | |
| }</pre> | |
| <p>按 Ctrl-Shift-I 组�?�键。IDE 会自动将 import 语�?�添加到该类的顶部。</p> | |
| <p class="tips">�?些代�?�?带有红色下划线，这表示类路径中并未包括所有需�?的包。�?�键�?�击项目节点，选择“属性�?，然�?��?�击“项目属性�?对�?框中的“库�?。�?�击“库�?窗格顶部的“添加�?�?�添加“对�?框 API�?。</p> | |
| <p>在 <tt>MyAction.java</tt> 类中�?次按 Ctrl-Shift-I 组�?�键。红色下划线将会消失，因为 IDE 在对�?框 API 中找到了所需的包。</p> | |
| <li>在“�?�?文件�?节点中，展开“XML 层�?。"<此层>"<tt></tt> 和 "<上下文中的此层>"<tt></tt> 这两个节点以�?�它们的�?节点共�?�组�?了<a href="https://platform.netbeans.org/tutorials/nbm-glossary.html">系统 Filesystem</a> �?览器。展开 "<此层>"<tt></tt>，�?展开 "Loaders"<tt></tt>，继续展开节点，直到显示您之�?所创建的�?作<tt></tt>。 | |
| <li>将 <tt>My Action</tt> 拖放到“打开�?<tt></tt>�?作下方，如下所示： | |
| <p align="left"><p><p align="left"><img border="1" src="../images/tutorials/filetype/60-action3.png" alt="系统 Filesystem �?览器。"> | |
| <p>从最�?�两步�?�以看出，系统 Filesystem �?览器�?�用于快速�?组在系统 Filesystem 中注册的�?�项的顺�?。 | |
| <li>�?次�?行该模�?�，�?作方法与上一节相�?�。 | |
| <li>使用上一节中所示的模�?�创建一个 ABC 文件，然�?�在�?个资�?管�?�器视图（如“项目�?窗�?�或“收�?夹�?窗�?�）中�?�键�?�击该文件的节点。 | |
| <p><p>请注�?，Abc 文件具有您在其模�?�中所指定的图标，并且�?�以从�?�键�?�击�?作所显示的上下文�?��?�中使用在其 <tt>layer.xml</tt> 文件中定义的一系列�?作： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-dummytemplate.png" alt="最终的“项目�?窗�?�。"> | |
| <li>选择新�?��?�项，将显示 Abc 文件的�??称和�?置： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-information.png" alt="信�?�。"> | |
| </ol> | |
| <p>现在，您已了解如何创建在“项目�?窗�?��?“文件�?窗�?�或“收�?夹�?窗�?�内给定类型文件的上下文�?��?�中显示的新�?作。</p> | |
| <h3 class="tutorial"><a name="topcomponent"></a>在窗�?�中打开文件</h3> | |
| <p>缺�?情况下，当用户打开在本教程中定义的类型的文件时，该文件将在基本编辑器中打开。但是，有时您�?�能需�?创建文件的�?�视表示，以使用户能够将�?部件拖放到该�?�视表示上。创建此类用户界�?�的第一步是，使用户�?�以在窗�?�中打开文件。本�?节将�?�您演示如何执行此�?作。 | |
| <ol> | |
| <li>�?�键�?�击项目节点，然�?�选择“新建�?>“窗�?�组件�?。将“窗�?��?置�?设置为 "editor" 并选中“在应用程�?�?�动时打开�?，如下所示： | |
| <p><p><p align="left"><img src="../images/tutorials/filetype/65-topc-1.png" alt="“新建�?作�?�?�导的第 1 步。"> | |
| <li>�?�击“下一步�?，然�?�在“类�??�?缀�?中键入 "Abc"： | |
| <p><p><p align="left"><img src="../images/tutorials/filetype/65-topc-2.png" alt="“新建�?作�?�?�导的第 1 步。"></p> | |
| <p>�?�击“完�?�?。</p> | |
| </li> | |
| <li>按如下所示更改 <tt>DataObject</tt> 的构造函数，将 <tt>DataObject</tt> 更改为使用 <tt><a href="http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/OpenSupport.html">OpenSupport</a></tt> 而�?是 DataEditorSupport： | |
| <p><pre>public AbcDataObject(FileObject pf, MultiFileLoader loader) | |
| throws DataObjectExistsException, IOException { | |
| super(pf, loader); | |
| CookieSet cookies = getCookieSet(); | |
| <b>//cookies.add((Node.Cookie) DataEditorSupport.create(this, getPrimaryEntry(), cookies)); | |
| cookies.add((Node.Cookie) new AbcOpenSupport(getPrimaryEntry()));</b> | |
| }</pre> | |
| <li>创建 <tt><a href="http://bits.netbeans.org/dev/javadoc/org-openide-loaders/org/openide/loaders/OpenSupport.html">OpenSupport</a></tt> 类： | |
| <p><pre>class AbcOpenSupport extends OpenSupport implements OpenCookie, CloseCookie { | |
| public AbcOpenSupport(AbcDataObject.Entry entry) { | |
| super(entry); | |
| } | |
| protected CloneableTopComponent createCloneableTopComponent() { | |
| AbcDataObject dobj = (AbcDataObject) entry.getDataObject(); | |
| AbcTopComponent tc = new AbcTopComponent(); | |
| tc.setDisplayName(dobj.getName()); | |
| return tc; | |
| } | |
| }</pre> | |
| <p class="tips">调整 TopComponent 以扩展 CloneableTopComponent，而�?是 TopComponent。将 TopComponent 的类修饰符�?�其构造函数的修饰符设置为 public 而�?是 private。 | |
| </ol> | |
| <p>�?次�?行该模�?�，当打开 Abc 文件时，<tt>OpenSupport</tt> 类便会处�?�此打开�?作，以便在 <tt>TopComponent</tt> 中打开该文件，而�?是在 <tt>DataEditorSupport</tt> 所�??供的基本编辑器中打开： | |
| <p><p align="left"><img src="../images/tutorials/filetype/65-topc-3.png" alt="“新建�?作�?�?�导的第 1 步。"></p> | |
| <p class="tips"><a href="https://platform.netbeans.org/tutorials/nbm-visual_library_zh_CN.html">NetBeans �?�视库教程</a>�??供了一个进一步开�?� TopComponent 的示例，以便以�?�视方�?显示文件内容（与本教程中定义的文件类型对应）。</p> | |
| <br /> | |
| <!-- ======================================================================================= --> | |
| <h3><a name="multiview"></a>创建多视图窗�?�</h3> | |
| <p>现在，我们已�?能够在窗�?�中打开文件，接下�?�我们将使该窗�?�更加有趣。我们将创建一个多视图窗�?�。多视图窗�?�的第一个标签通常用于显示文件的�?�视表示，第二个标签则通常显示�?视图。此外，该窗�?�也�?�包�?�两个以上的标签，�?个标签�??供有关已打开文件的更为详细的信�?�。 | |
| <ol> | |
| <li>�?�键�?�击项目节点，然�?�选择“属性�?。在“项目属性�?对�?框中，选择“库�?，然�?��?�击“添加�?。设置对“多视图窗�?��?的�?赖关系。�?�击“确定�?，然�?��?次�?�击“确定�?以退出“项目属性�?对�?框。 | |
| <li><p>对于�?在多视图窗�?�中创建的�?个标签，创建一个用于实现 <tt>MultiViewDescription</tt> 和 <tt>Serializable</tt> 的类。</p><p>就本教程而言，首先将创建一个�??为 <tt>AbcMultiviewDescription1</tt> 的类以实现指定类：</p> | |
| <pre>public class AbcMultiviewDescription1 implements MultiViewDescription, Serializable { | |
| public int getPersistenceType() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| public String getDisplayName() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| public Image getIcon() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| public HelpCtx getHelpCtx() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| public String preferredID() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| public MultiViewElement createElement() { | |
| throw new UnsupportedOperationException("Not supported yet."); | |
| } | |
| }</pre> | |
| <p class="tips">在上述 <tt>AbcMultiviewDescription1</tt> 类中，方法 <tt>createElement()</tt> 返回 MultiViewElement。但是，此处需�?返回的是 <tt>TopComponent</tt>，这将在下一步中完�?。</p> | |
| <li>�?写类签�??。�?为上一步中的�??述�??供多视图元素，我们需�?扩展 <tt>JPanel</tt>（而�?是 <tt>TopComponent</tt>），而且还需�?实现 <tt>MultiViewElement</tt>： | |
| <pre>public final class AbcTopComponent extends JPanel implements MultiViewElement {</pre> | |
| <p>现在，您需�?在 <tt>TopComponent</tt> 中删除（或注释掉）方法 <tt>findInstance()</tt>�?<tt>getPersistenceType()</tt>�?<tt>writeReplace()</tt> 和 <tt>preferredID()</tt>。 | |
| <li>暂时为�?个所需的方法�??供�?�常简�?�的实现。首先，在 <tt>TopComponent</tt> 类的顶部定义一个新的 <tt>JToolbar</tt>： | |
| <pre>private JToolBar toolbar = new JToolBar();</pre> | |
| <p>接下�?�，按如下所示实现方法： | |
| <pre> public JComponent getVisualRepresentation() { | |
| return this; | |
| } | |
| public JComponent getToolbarRepresentation() { | |
| return toolbar; | |
| } | |
| public void setMultiViewCallback(MultiViewElementCallback arg0) { | |
| } | |
| public CloseOperationState canCloseElement() { | |
| return null; | |
| } | |
| public Action[] getActions() { | |
| return new Action[]{}; | |
| } | |
| public Lookup getLookup() { | |
| return Lookups.singleton(this); | |
| } | |
| public void componentShowing() { | |
| } | |
| public void componentHidden() { | |
| } | |
| public void componentActivated() { | |
| } | |
| public void componentDeactivated() { | |
| } | |
| public UndoRedo getUndoRedo() { | |
| return UndoRedo.NONE; | |
| }</pre> | |
| <li>现在，您�?�以�?新定义 <tt>AbcMultiviewDescription1</tt>，如下所示： | |
| <pre>public class AbcMultiviewDescription1 implements MultiViewDescription, Serializable { | |
| public int getPersistenceType() { | |
| return TopComponent.PERSISTENCE_ALWAYS; | |
| } | |
| public String getDisplayName() { | |
| return "Tab 1"; | |
| } | |
| public Image getIcon() { | |
| return ImageUtilities.loadImage("/org/myorg/abcfiletype/Datasource.gif"); | |
| } | |
| public HelpCtx getHelpCtx() { | |
| return null; | |
| } | |
| public String preferredID() { | |
| return "AbcMultiviewDescription1"; | |
| } | |
| public MultiViewElement createElement() { | |
| return new AbcTopComponent(); | |
| } | |
| }</pre> | |
| <li>更改 <tt>OpenSupport</tt> 类中的 <tt>createCloneableTopComponent</tt> 方法，以通过在上�?�部分创建的 <tt>MultiViewDescription</tt> 类打开 <tt>TopComponent</tt>： | |
| <pre>protected CloneableTopComponent createCloneableTopComponent() { | |
| // Create an array of multiview descriptors: | |
| AbcMultiviewDescription1 firstTab = new AbcMultiviewDescription1(); | |
| MultiViewDescription[] descriptionArray = { firstTab }; | |
| // Create the multiview window: | |
| CloneableTopComponent tc = MultiViewFactory.createCloneableMultiView(descriptionArray, firstTab, null); | |
| tc.setDisplayName(entry.getDataObject().getName()); | |
| return tc; | |
| }</pre> | |
| <p class="tips"><tt>MultiViewFactory.createCloneableMultiView</tt> 中的第二个�?�数决定缺�?情况下所打开的标签。在本示例中为 <tt>AbcMultiViewDescription1</tt> 定义的标签 <tt>firstTab</tt>。</p> | |
| <li><p>�?次安装并打开文件。现在，您已创建包�?�一个标签的多视图窗�?�：</p> | |
| <p><img border="1" src="../images/tutorials/filetype/65-mvdeployed.png" alt="已部署的多视图"> | |
| </ol> | |
| <p>现在，多视图窗�?�中�?�有一个标签。对于�?个其他标签，创建一个新的 <tt>MultiviewDescription</tt> 类和一个新的 <tt>JPanel</tt>，然�?�实例化 <tt>OpenSupport</tt> 扩展类中的 <tt>MultiViewDescription</tt> 类，如上所示。 | |
| </div> | |
| <!-- ======================================================================================= --> | |
| <h2><a name="share"></a>创建�?�共享的模�?�二进制文件</h2> | |
| <p>该模�?�现已完�?，您�?�以将其交给其他用户使用了。为此，您需�?创建并分�?�一个二进制 "NBM"（NetBeans 模�?�）文件。 | |
| <div class="indent"> | |
| <ol> | |
| <li>在“项目�?窗�?�中，�?�键�?�击 "Abc File Type"<tt></tt> 项目，然�?�选择“创建 NBM�?。 | |
| <p><p>将创建 NBM 文件，您�?�以在“文件�?窗�?� (Ctrl-2) 中查看它： | |
| <p><p align="left"><img border="1" src="../images/tutorials/filetype/60-shareable-nbm.png" alt="�?�共享的 NBM。"> | |
| <li>例如，通过 <a href="http://plugins.netbeans.org/PluginPortal/">NetBeans �?�件门户</a>�?�其他人�??供该文件。接收者应使用�?�件管�?�器（“工具�?>“�?�件�?）�?�安装它。 | |
| </ol> | |
| </div> | |
| <!-- ======================================================================================== --> | |
| <br> | |
| <div class="feedback-box"><a href="https://netbeans.org/about/contact_form.html?to=3&subject=Feedback:%20File%20Type%20Module%20Tutorial">请将您的�?�?和建议�?��?给我们</a></div> | |
| <br style="clear:both;" /> | |
| <!-- ======================================================================================== --> | |
| <h2><a name="nextsteps"></a>�?�续步骤</h2> | |
| <p>有关创建和开�?� NetBeans 模�?�的详细信�?�，请�?��?以下资�?： | |
| <ul> | |
| <li><a href="https://platform.netbeans.org/index.html">NetBeans 平�?�主页</a></li> | |
| <li><a href="https://netbeans.org/download/dev/javadoc/">NetBeans API 列表（当�?开�?�版本）</a></li> | |
| <li><a href="https://netbeans.org/kb/trails/platform_zh_CN.html">其他相关教程</a></li></ul> | |
| </p> | |
| <!-- ======================================================================================== --> | |
| <!-- | |
| <h2><a name="version"></a>Versioning </h2> | |
| <p> | |
| <table width="76%" > | |
| <tbody> | |
| <tr> | |
| <td> | |
| <div align="left"><b>Version</b></div> | |
| </td> | |
| <td> | |
| <div align="left"><b>Date</b></div> | |
| </td> | |
| <td> | |
| <div align="left"><b>Changes</b></div> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 1 | |
| </td> | |
| <td> | |
| 25 August 2005 | |
| </td> | |
| <td> | |
| <ul><li>Initial version. | |
| <li>To do: | |
| <ul><li>Add post-creation customizations (i.e., the "Extending Support for the New File Type" section). | |
| <li>Explain what the generated files are for (placeholders currently). | |
| <li>Explain the layer file's entries. | |
| <li>Explain the first File Type panel (placeholders currently). | |
| <li>Maybe create a separate tutorial for recognizing XML files.</ul></ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 2 | |
| </td> | |
| <td> | |
| 23 September 2005 | |
| </td> | |
| <td> | |
| <ul><li>A lot of info added from the FAQ and added the Action wizard and System Filesystem Browser. | |
| <li>To do: | |
| <ul><li>Explain <tt>LoaderBeanInfo.java</tt> and <tt>Resolver.xml</tt> (one line each) | |
| <li>Maybe create a separate tutorial for recognizing XML files. | |
| <li>Using Tomcat GIF maybe not good idea. | |
| <li>Maybe the action should do something useful. | |
| <li>Maybe direct links to FAQ not good idea. | |
| <li>Probably more needed on <tt>layer.xml</tt> file. | |
| <li>Maybe other useful apisupport functionality could be added to this scenario. | |
| <li>More info needed on MIME types. | |
| <li>The introductory paragraphs should be illustrated with a graphic. A diagram to | |
| show relationship between node, dataobject, fileobject, dataloader, etc.</ul></ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 3 | |
| </td> | |
| <td> | |
| 28 September 2005 | |
| </td> | |
| <td> | |
| <ul><li>Integrated comments from Jesse Glick. | |
| <li>To do: | |
| <ul> <li>More info needed on MIME types. | |
| <li>The introductory paragraphs should be illustrated with a graphic. A diagram to | |
| show relationship between node, dataobject, fileobject, dataloader, etc. | |
| <li>Many Javadoc links to be added (also for <tt>performAction</tt>. | |
| <li>Info on cookies, cookie actions, cookie classes needed. | |
| <li>Action ended up in text-html even though I chose my own mime type. | |
| <li>Need to explain or link to explanation for instance, shadow, etc. | |
| <li>Platform Manager needs to be mentioned in the context of installing | |
| in target platform. | |
| <li>Show how to add properties to the property sheet.</ul></ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 4 | |
| </td> | |
| <td> | |
| 4 October 2005 | |
| </td> | |
| <td> | |
| <ul><li>Added two diagrams in the introductory paragraphs, from Tim Boudreau's JavaOne presentation. | |
| <li>To do: | |
| <ul> <li>More info needed on MIME types. | |
| <li>Many Javadoc links to be added (also for <tt>performAction</tt>). | |
| <li>Need to create section near the start: "Related FAQs": | |
| <ul><li>Info on cookies, cookie actions, cookie classes needed. | |
| <li>Need to explain or link to explanation for instance, shadow, etc. | |
| <li>DataLoader, DataObject, etc.</ul> | |
| <li>Platform Manager needs to be mentioned in the context of installing | |
| in target platform. | |
| <li>Show how to add properties to the property sheet. | |
| <li>Mention the dummy template that you get, how to modify it, | |
| and how to set the description in the New File wizard.</ul></ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 4 | |
| </td> | |
| <td> | |
| 4 November 2005 | |
| </td> | |
| <td> | |
| <ul><li>Added downloadable source code, new 'Installing the Sample' section, and link to | |
| Syntax Highlighting tutorial at the end. | |
| <li>To do: | |
| <ul> <li>Same items as on 4 October still to be done.</ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 5 | |
| </td> | |
| <td> | |
| 29 November 2005 | |
| </td> | |
| <td> | |
| <ul><li>Added links to brand new Component Palette tutorial. | |
| <li>To do: | |
| <ul> <li>Same items as on 4 October still to be done.</ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 6 | |
| </td> | |
| <td> | |
| 21 April 2006 | |
| </td> | |
| <td> | |
| <ul><li>Changed the title from "DataLoader Module Tutorial" to "Recognizing a File Type Tutorial". | |
| <li>To do: | |
| <ul> <li>Same items as on 4 October still to be done.</ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 7 | |
| </td> | |
| <td> | |
| 17 November 2007 | |
| </td> | |
| <td> | |
| <ul><li>Updated the whole tutorial to 6.0, replaced all screenshots, and | |
| now [because the 6.0 IDE already provides support for manifest files], the | |
| tutorial focuses on imaginary Abc files. | |
| <li>To do: | |
| <ul> <li>Need to replace the download, which is the same as before, dealing with manifest files. | |
| <li>Same items as on 4 October still to be done. | |
| <li>Added OpenSupport into TopComponent, with a reference to Visual Library.</ul> | |
| <li>Changed title to File Type Integration Tutorial | |
| <li>Tweaked several places throughout tutorial, for 6.0 | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 8 | |
| </td> | |
| <td> | |
| 15 April 2008 | |
| </td> | |
| <td> | |
| Updated the styles (badge, table of contents, required software table) | |
| to the new format. | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 9 | |
| </td> | |
| <td> | |
| 16 July 2008 | |
| </td> | |
| <td> | |
| Created new version for 6.5, because of changes to the | |
| way file type recognition is done in that release. To do: | |
| <ul> | |
| <li>6.5-specific badge | |
| <li>Required software table | |
| <li>Search for DataNode, BeanInfo, DataLoader and reword | |
| <li>Check screenshots | |
| <li>Make sure all the sections work as before | |
| </ul> | |
| </td> | |
| </tr> | |
| <tr> | |
| <td> | |
| 10 | |
| </td> | |
| <td> | |
| 4 April 2009 | |
| </td> | |
| <td> | |
| Worked through everything and added the multiview section. | |
| </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| --> | |
| </body> | |
| </html> |