当前页面: 开发资料首页 → Netbeans 专题 → NetBeans File Template 模块教程
摘要: NetBeans File Template 模块教程 反馈 本教程演示如何创建包含文件模板的模块。将该模块安装到 IDE 中之后,在 New File 向导中便可以使用该文件模板。拥有包含文件模板的...
本教程演示如何创建包含文件模板的模块。将该模块安装到 IDE 中之后,在 New File 向导中便可以使用该文件模板。拥有包含文件模板的模块之后,共享文件模板便很容易,NetBeans IDE 5.0 允许您创建一个其他人可以使用的二进制文件,然后其他人通过 Update Center 安装它。
文件模板由模板文件、HTML 描述文件和图标组成。HTML 描述文件显示 New File 向导中有关该模板的信息。图标标识该模板并使其与 New File 向导中的其他模板区分开来。在本教程中,通过将现有文件模板的内容复制到空文件中来创建新的文件模板。然后,为 New File 向导设置描述文件和区别图标,在 NetBeans 配置文件即 layer.xml 文件中注册该模板、HTML 描述文件和图标。
注意: 如果您使用 New File Type 向导,则将自动为您创建文件模板。当使用 New File Type 向导时,本教程中介绍的手动步骤是不必要的。New File Type 向导还允许您选择图标,它还创建一个 HTML 描述文件。New File Type 向导自动在 layer.xml 文件中注册文件模板、HTML 描述文件和图标。因此,如果您要创建的文件模板与新的文件类型有关,则最好使用 New File Type 向导。有关详细信息,请参阅 NetBeans DataLoader 模块教程。
本教程将介绍以下主题:
有关使用 NetBeans 模块的详细信息,请参阅 NetBeans 网站上的 NetBeans Development Project 主页。如果有问题,请访问 NetBeans Developer FAQ 或使用本页顶部的反馈链接。
开始之前,需要在您的计算机上安装以下软件:
IDE 创建 Additional File Templates 项目。该项目包含所有资源和项目元数据,如该项目的 Ant 构建脚本。该项目在 IDE 中打开。您可以在 Projects 窗口 (Ctrl-1) 中查看其逻辑结构,在 Files 窗口 (Ctrl-2) 中查看其文件结构。例如,现在 Projects 窗口应该如下所示:
有关以上每个文件的基本信息,请参阅 NetBeans 插件模块的快速入门指南。
文件模板由模板文件、HTML 描述文件和图标组成。创建新文件模板的简便方法是将现有文件模板的内容复制到空文件中。然后,为 New File 向导设置描述文件和区分图标之后,您准备在 layer.xml 文件中注册该模板。
Java Class 模板将在 Source Editor 中打开:
/* * __NAME__.java * * Created on __DATE__, __TIME__ * * To change this template, choose Tools | Options and locate the template under * the Source Creation and Management node. Right-click the template and choose * Open. You can then make changes to the template in the Source Editor. */ package Templates.Classes; /** * * @author __USER__ */ public class Class { /** Creates a new instance of __NAME__ */ public Class() { } }
注意到 Java Class 模板包含使用 New File 向导创建文件时填写的占位符。占位符如下所示:
一个名为 BrandedJavaClass.template 的空文件在 Source Editor 中打开,它的节点显示在 Projects 窗口中。
/* * Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved. U.S. * Government Rights - Commercial software. Government users are subject * to the Sun Microsystems, Inc. standard license agreement and * applicable provisions of the FAR and its supplements. Use is subject * to license terms. * * This distribution may include materials developed by third parties. * Sun, Sun Microsystems, the Sun logo, Java and J2EE are trademarks * or registered trademarks of Sun Microsystems, Inc. in the U.S. and * other countries. * * Copyright (c) 2005 Sun Microsystems, Inc. Tous droits reserves. * * Droits du gouvernement americain, utilisateurs gouvernementaux - logiciel * commercial. Les utilisateurs gouvernementaux sont soumis au contrat de * licence standard de Sun Microsystems, Inc., ainsi qu'aux dispositions * en vigueur de la FAR (Federal Acquisition Regulations) et des * supplements a celles-ci. Distribue par des licences qui en * restreignent l'utilisation. * * Cette distribution peut comprendre des composants developpes par des * tierces parties. Sun, Sun Microsystems, le logo Sun, Java et J2EE * sont des marques de fabrique ou des marques deposees de Sun * Microsystems, Inc. aux Etats-Unis et dans d'autres pays. */
一个空的 HTML 文件在 Source Editor 中打开,它的节点显示在 Projects 窗口中。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title></title> </head> <body> Creates Java Class branded with <b>Sun Microsystems</b> copyright text. </body> </html>
图标伴随 New File 向导中的文件模板。它标识自己并使自己区别于其他文件模板。图标的尺寸必须为 16x16 像素。如果您没有自己的图标,则可以在 NetBeans IDE 5.0 安装目录中的以下位置找到一些 16x16 的图标:
enterprise2\jakarta-tomcat-5.5.7\server\webapps\admin\images
将该图标命名为 Icon_BrandedJavaClass 并将其添加到 org.myorg.additionalfiletemplates 包中。
现在 Projects 窗口应该显示如下:
创建文件模板之后,您必须在 NetBeans System Filesystem 中注册它。layer.xml 文件就是用于这个目的。
<folder name="Templates"> <attr name="Classes/BrandFiles" boolvalue="true" /> <attr name="BrandFiles/GUIForms" boolvalue="true" /> <folder name="BrandFiles"> <attr name="SystemFileSystem.localizingBundle" stringvalue="org.myorg.additionalfiletemplates.Bundle"/> <file name="BrandedJavaClass.java" url="BrandedJavaClass.template"> <attr name="template" boolvalue="true"/> <attr name="SystemFileSystem.localizingBundle" stringvalue="org.myorg.additionalfiletemplates.Bundle"/> <attr name="SystemFileSystem.icon" urlvalue="nbresloc:/org/myorg/additionalfiletemplates/Icon_BrandedJavaClass.gif"/> <attr name="instantiatingIterator" methodvalue="org.netbeans.modules.java.ui.wizard.JavaWizardIterator.singleton" /> <attr name="instantiatingWizardURL" urlvalue="nbresloc:/org/myorg/additionalfiletemplates/Desc_BrandedJavaClass.html"/> </file> </folder> </folder>
下面解释以上标记:
Templates/BrandFiles=Branded Files Templates/BrandFiles/BrandedJavaClass.java=Branded Java Class
下面解释以上字符串:
IDE 使用 Ant 构建脚本来构建和安装您的模块。构建脚本是创建模块项目时为您创建的。
模块即在目标 IDE 或平台中构建和安装。目标 IDE 或平台打开,您可以试用新的模块。默认目标 IDE 或平台是由开发 IDE 的当前实例使用的安装平台。注意到当您运行模块时,您将使用临时测试用户目录,而不是开发 IDE 的用户目录。
将创建 NBM 文件并且可以在 Files 窗口中查看它 (Ctrl-2):
有关创建和开发 NetBeans 模块的更多信息,请参见以下资源:
版本
|
日期
|
更改
|
1 | 2005 年 6 月 26 日 | 初始版本 |
2 | 2005 年 6 月 28 日 |
|
3 | 2005 年 10 月 2 日 |
|
4 | 2005 年 10 月 3 日 |
|