NetBeans Project Template 模块教程
反馈
本教程演示如何创建使新项目模板可用于 IDE New Project 向导的模块。IDE 提供几个项目模板，例如 Web Application、Java Project with Existing Sources、EJB Module 和 Enterprise Application。每个项目模板都提供基本的源结构和几个具有示例代码的文件。例如，Web Application 项目模板提供符合 Java BluePrints 的源结构和符合 Jakarta 建议的源结构。此外，它还提供了默认的 index.jsp 文件、web.xml 部署描述符以及在 Web Application 模板的向导中选中的服务器部署描述符。
在本教程中，您添加 Wicket（Java Web 应用程序框架）的项目模板。当创建 Wicket 项目模板时，一定要记住以下特定于 Wicket 的要求：
- 没有 JSP 文件。每个网页都由 Java 类和 HTML 文件组成，它们的名称相同并且都位于同一包结构中。
- 没有 XML 配置文件。一个 Java 类提供应用程序级别的信息，如应用程序的主页。
- 特定于 Wicket 的库和参考 Wicket servlet 以便处理请求的 web.xml 部署描述符文件。
创建和安装该模块之后，New Project 向导将包含 Wicket 项目模板并且 Library Manager 将包含 Wicket JAR 文件。
本教程将介绍以下主题：
安装完软件之后，本教程可以在 20 分钟之内完成。
有关使用 NetBeans 模块的详细信息，请参阅 NetBeans 网站上的 NetBeans Development Project 主页。如果有问题，请访问 NetBeans Developer FAQ 或使用本页顶部的反馈链接。
安装软件
开始之前，需要在您的计算机上安装以下软件：
- NetBeans IDE 5.0（下载）
- Java Standard Development Kit (JDK™) version 1.4.2（下载）或 5.0（下载）
准备 Wicket 项目模板
- 下载并解压缩 Wicket 1.0.3。
注意： 本教程同样适用于其他版本的 Wicket，但是在其他版本中 Wicket 的库可能位于与本教程中提到的文件夹不同的文件夹中。
- 选择 File > New Project。在 Categories 下选择 Web。在 Projects 下，选择 Web Application 并单击 Next。
- 在 Project Name 下，输入 WicketApplication。将 Project Location 更改为计算机上的任意目录。从现在起，我们将此目录称为 $PROJECTHOME。
- 选择源结构将遵守的标准，这纯粹属于个人偏爱：
- 保留所有其他默认值。单击 Finish。
IDE 将创建 $PROJECTHOME/WicketApplication 项目文件夹。项目文件夹包含所有源和项目元数据，如项目的 Ant 构建脚本。WicketApplication 项目在 IDE 中打开。可以在 Projects 窗口中查看其逻辑结构，在 Files 窗口中查看其文件结构。
- 删除 index.jsp。Wicket 网页由 Java 类和 HTML 文件组成。因此，默认的 JSP 页面是多余的。
现在 Wicket 项目的模板基础已就绪。在本例中，标准 Web 应用程序和 Wicket 应用程序之间唯一的差别就是存在 index.jsp 文件。您可以根据需要进行更多修改。在下一部分中，您创建模块项目，打包 Wicket 库，打包项目模板并在 New Project 向导中安装它。
创建模块项目
- 选择 File > New Project (Ctrl-Shift-N)。在 Categories 下，选择 NetBeans Plug-in Modules。在 Projects 下，选择 Module Project 并单击 Next。
- 在 Name and Location 面板中，在 Project Name 中键入 WicketTemplate。将 Project Location 更改为您计算机上的任何目录，如 c:\mymodules。选中 Standalone Module 单选按钮和 Set as Main Project 复选框。现在该面板应该如下所示：
单击 Next。
- 在 Basic Module Configuration 面板中，用 myorg 替换 Code Name Base 中的 yourorghere，从而整个 Code Name Base 为 org.myorg.wickttemplate。留出本地化包和 XML 层的位置，以便它们存储在名为 org/myorg/wickttemplate 的包中。该面板应该如下所示：
- 单击 Finish。
IDE 创建 WicketTemplate 项目。该项目包含所有资源和项目元数据，如该项目的 Ant 构建脚本。该项目在 IDE 中打开。您可以在 Projects 窗口 (Ctrl-1) 中查看其逻辑结构，在 Files 窗口 (Ctrl-2) 中查看其文件结构。例如，现在 Projects 窗口应该如下所示：
有关以上每个文件的基本信息，请参阅 NetBeans 插件模块的快速入门指南。
对 Wicket 库进行打包
- 右键单击 WicketTemplate 项目节点并选择 New > J2SE Library Descriptor。单击 Next。
- 在 Select Library 面板中，单击 Manage Libraries。在 Library Manager 中，单击 New Library 并键入 Wicket 作为 Library Name。单击 OK。
- 单击 Add JAR/Folder 并浏览到您解压缩 Wicket 1.0.3 的文件夹。
- 使用 Browse JAR/Folder 对话框向 Classpath 选项卡中添加以下 JAR 文件：
- wicket-1.0.3
- lib/commons-fileupload-1.0
- lib/commons-logging-1.0.4
- lib/concurrent-1.3.3
- lib/dom4j-1.4
- lib/log4j-1.2.8
- lib/ognl-2.6.7
现在 Library Manager 的 Classpath 选项卡如下所示：
- 在 Javadoc 选项卡中，添加 docs/apidocs 文件夹。
现在 Library Manager 的 Javadoc 选项卡如下所示：
- 单击 OK。在 Select Library 面板中，选择新创建的 Wicket 库：
单击 Next。
- 在 Name and Location 面板中，保留所有默认值。
- 单击 Finish。
Projects 窗口现在包含 Wicket J2SE 库描述符；Files 窗口显示已经添加到该模块的 Wicket 归档文件：
对 Wicket 项目模板进行打包
- 右键单击 WicketTemplate 项目节点并选择 New > Project Template。
- 在 Select Project 面板中，自动选择您要打包作为示例的项目，如下所示。
如果 IDE 中打开了很多项目，则使用下拉列表来选择 Wicket Application。
单击 Next。
- 在 Name and Location 面板中，键入 WicketApplication 作为模板名称，键入 Wicket Application 作为显示名称，然后在 Category 下拉列表中选择 Web，如下所示：
- 单击 Finish。
IDE 执行以下操作：
- 创建包含您的项目的 ZIP 文件
- 提供一个 Java 面板和一个在 New Project 向导中用来创建示例的迭代程序
- 为在 New Project 向导中显示的描述提供一个 HTML 文件
- 在 XML 层文件中注册示例
- 向 bundle.properties 文件中添加本地化字符串
现在 Projects 窗口应该显示如下：
最后，您将用 Wicket 的图标替换模板的默认图标。要获得 Wicket 的图标，请右键单击下面的图像并将其保存在您的文件系统中：
- 在 Important Files 节点中，展开 XML Layer。两个节点 <xml layer> 和 <this layer in context> 以及它们的子节点组成了 System Filesystem Browser。展开 <this layer>，展开 Templates，继续展开节点，直到您看到上面创建的模板。
- 右键单击新模板的节点，然后选择 Pick Icon，如下所示：
浏览到您保存 Wicket 图标的位置。注意默认图标更改为 Wicket 的图标：
现在您可以构建、安装和使用包含 Wicket 库和模板的模块了。
构建和安装模块
IDE 使用 Ant 构建脚本来构建和安装您的模块。构建脚本是创建模块项目时为您创建的。
安装 NetBeans 模块
使用 NetBeans 模块
- 选择 File > New Project (Ctrl-Shift-N)。
将打开 New Project 向导并显示新 Wicket Application 模板：
- 选择 Wicket Application 并单击 Next.将出现 Name and Location 面板。在项目名称字段中键入一个名称。
- 单击 Finish。
IDE 打开并显示新创建的项目示例。注意没有创建 index.jsp。
- 右键单击 Libraries 节点并选择 Add Library，如下所示：
- 选择 Wicket 库并单击 Add Library.
- 创建一个新的 Java 类，并注意有代码完成和 Wicket 库的 Javadoc 支持，如下所示：
创建可共享的模块二进制文件（NBM 文件）
NBM 文件是一个 NetBeans 模块，该模块已被打包以便通过 Web 发送。NBM 文件和模块 JAR 文件之间的主要差别为：
- NBM 文件是压缩的文件。
- NBM 文件可以包含多个 JAR 文件，即模块可以将它们使用的任何库打包到它们的 NBM 文件中。
- NBM 文件包含 NetBeans 将用来在 Update Center 显示有关它信息的元数据，如 manifest 内容、许可等。
- 出于安全考虑，NBM 文件通常都有签名。
NBM 文件只是具有特殊扩展名的 ZIP 文件。它们使用 JDK 机理给 JAR 文件签名。除非您正在执行一些不同寻常的操作，否则不需要担心 NBM 文件的内容，只需让 NBM 创建的标准 Ant 构建脚本为您完成所有工作。IDE 根据在 Project Properties 对话框的项目中输入的选项生成构建脚本。您可以在 Project Properties 对话框中设置模块的依存关系、版本控制和打包信息。通过为项目编辑 Ant 脚本和 Ant 属性，您可以进一步自定义程序执行。
- 在 Projects 窗口中，右键单击 WicketTemplate 项目，并选择 Create NBM。
将创建 NBM 文件并且可以在 Files 窗口中查看它 (Ctrl-2)：
- 通过电子邮件使其他人也可以使用。
下一步
有关创建和开发 NetBeans 模块的更多信息，请参见以下资源：
版本控制
|
版本
|
日期
|
更改
|
|
1
|
2005 年 10 月 1 日
|
- 初始版本。
- 待办事项：
- P1。介绍如何创建向导，该向导允许用户指定网页数量，然后 IDE 为每个网页创建 Java 类和 HTML 文件；web.xml 自动被应用程序名称的 servlet 定义填充。
- P1。添加一些后处理自定义步骤（例如，如何将不同类别的示例放置到 New Project 向导中）。
- P2。添加有关每个创建的文件的详细信息（当前只有一个句子，应该扩展）。
- P2。解释所生成文件和获得的项目模板向导之间的关系。
- P2。有关要添加的 XML 层文件的信息。
- P3。向每个部分添加介绍性的语句。
- 注意： http://www.netbeans.org/issues/show_bug.cgi?id=65595
|
