从 NetBeans IDE 3.6 转换到 4.0 Beta
由
John Jullion-Ceccarelli
供稿和修订
NetBeans IDE 4.0 是产品发展过程中的一个重要里程碑。它引入了基于 Ant 的全新项目系统，可为您提供更严格的类路径管理、更多样化的生成和运行选项，以及与市面上所有 IDE 的 Ant 最紧密的集成。对于用惯了 NetBeans IDE 3.6“安装”系统的用户来说，它还对工作流程进行了重大改进。
本指南旨在帮助您将应用程序和 IDE 设置从 NetBeans IDE 3.6 转换到 NetBeans IDE 4.0，并说明如何使用全新的 NetBeans IDE 项目系统来提高工作效率。
目录
基于 Ant 的项目系统
NetBeans IDE 4.0 有一个直接基于 Apache Ant 的全新项目系统。NetBeans IDE 项目系统使用 Ant 生成脚本来编译、运行、执行和测试应用程序，以及存储与项目有关的所有元数据。
您不必精通 Ant，甚至无需了解如何在 NetBeans IDE 中使用 Ant 来处理项目。IDE 提供了一组标准项目模板 ，其中包含开发应用程序所需的全部内容。您可以在项目的 GUI 中配置所有基本的编译和运行环境选项。
高级 Ant 用户可以充分利用 Ant 的强大功能来定制其生成进程。您可以通过覆盖标准项目的 Ant 目标来扩展其生成脚本。IDE 还包含一组自由格式项目模板 ，您可以通过这些模板使用自己的 Ant 脚本来控制项目的执行和编译。
返回页首
与 NetBeans IDE 3.6 进行比较
在 NetBeans IDE 4.0 中，您可以为每个源包根目录创建一个标准项目，然后在它们之间设置定向的类路径依存关系。在每个项目中，您可以为应用程序的编译、运行和测试设置一个单独的类路径。如果您使用自己的 Ant 脚本来生成和执行项目，则可以创建一个自由格式的项目，其中可以包含多个具有单独类路径的源文件夹。
下表列出了 NetBeans IDE 3.6 和 4.0 之间的一些最直观的差异：
NetBeans IDE 3.6 NetBeans IDE 4.0
源文件夹
每个项目都可以包含多个源文件夹和 Java 源包根目录。
每个标准项目只能包含一个含有 Java 源包根目录的源文件夹（对于 J2SE 项目，还可以包含一个 JUnit 测试包文件夹）。
自由格式的项目可以包含多个源文件夹，但前提是 Ant 脚本知道这些源文件夹并能够相应处理其类路径。
类路径
每个项目只有一个类路径。类路径由资源管理器的“文件系统”窗口中安装的全部内容组成。
每个标准项目都有一个针对项目的类路径，但也可以配置不同的类路径版本以进行测试、运行和调试。
自由格式项目的类路径由 Ant 脚本控制，因此可能会比较复杂。
访问“文件”和“项目”视图
必须安装要访问的每个文件夹。“文件系统”窗口只为源内容提供一个基于文件夹的视图。您可以在“项目”窗口中添加各个文件。
“项目”窗口提供 Java 源代码和 Web 应用程序的逻辑组织结构。这些源显示在每个包的“源包”节点下。“文件”窗口显示磁盘中项目文件夹的物理布局。您可以在“收藏夹”窗口中访问计算机中的任意位置。
生成输出文件
在“文件系统”窗口中创建 JAR 或 WAR 方法节点，然后使用该节点的属性和上下文菜单生成 JAR 或 WAR 文件。
每次生成标准 J2SE 项目时，都会生成一个 JAR 文件。每次生成 Web 项目时，都会生成一个 WAR 文件。对于 J2SE 项目，您可以在“项目属性”对话框的“创建 JAR”页中设置过滤器和压缩选项；对于 Web 项目，则在“项目属性”对话框的“包装项目”页中设置这些选项。标准的 J2SE 和 Web 项目为每个项目生成一个输出文件。
在自由格式的项目中，输出文件的生成是由 Ant 脚本控制的。
共享项目
无法在开发者之间共享项目和项目设置。
所有的项目元数据都以 Ant 脚本、Ant 属性文件和几个 XML 文件的形式包含在项目文件夹中。您可以将此元数据置于版本控制之下，并将某些设置标识为仅用于您的安装。
配置设置
可以在“选项”窗口中配置所有设置。您可以使用为项目或各个文件分配的服务类型来管理执行、调试和编译设置。
可以在“项目属性”对话框中设置与项目有关的设置，如类路径、编译设置以及运行环境参数等。您可以通过编辑项目的 Ant 脚本和 Ant 属性文件，对各种设置进行进一步的配置。
可以在“选项”窗口中配置 IDE 范围内的常规设置，如语法着色、Web 浏览器设置以及系统设置。
Web 应用程序
必须安装要访问的每个文件夹。“文件系统”窗口只为源内容提供一个基于文件夹的视图。您可以在“项目”窗口中添加各个文件。IDE 支持 JSP 1.2 和 2.0 规范；IDE 不编译 JSP，但会对其进行验证。Tomcat Server 5.0.19 与 NetBeans 进行了集成。
与 J2SE 项目一样，Web 项目也是使用 Ant 支持的新项目系统进行开发的。Web 项目可以使用来自多个文件夹的源，如 WEB-INF/classes 之外的 Web 类以及 WEB-INF/lib 之外的库。如果 Web 项目依赖于某一 Java 类库，则可以将该库作为单独的项目进行处理。为 JSP 2.0 规范提供了增强的支持，为标记处理程序和标记文件提供向导，并为标记库描述符提供了代码完成。重新引入了 JSP 编译，现在由 Ant 进行处理。Tomcat Server 5.0.27 与 NetBeans IDE 4.0 进行了集成。
返回页首
标准项目与自由格式的项目
下表列出了 NetBeans IDE 4.0 中标准项目和自由格式的项目之间的主要差异：
标准项目 自由格式的项目
IDE 使用 NetBeans 生成的 Ant 生成脚本来生成、运行、清除、测试和调试应用程序。
IDE 使用现有 Ant 脚本中的目标来生成、运行、清除、测试和调试应用程序。如果 Ant 脚本不包含其中某些函数的目标，则无法使用这些函数。您可以在 Ant 脚本或辅助 Ant 脚本中编写目标来实现这些函数。
每个项目只能包含一个源文件夹，对于 J2SE 项目，还可以包含一个测试文件夹。要使用多个源文件夹，可以为每个源文件夹创建一个单独的项目，然后在项目之间创建依存关系。
每个项目可以使用任意数量的源文件夹。可以在创建项目后添加和删除源文件夹。也可以创建与其他 NetBeans 项目之间的依存关系。
项目类路径是由在“编译类”页（属于“项目属性”对话框）中设定的设置来控制的。将立即在 IDE 生成的 Ant 脚本中注册所有更改。
项目类路径是由 Ant 脚本控制的。“项目属性”对话框的“类路径”页中的类路径设置只通知 IDE 要将哪些类用于代码完成和重构。在 Ant 脚本中更改类路径设置时，必须更新项目属性中的设置。
可使用以下方法来定制生成进程：在“项目属性”对话框中设置基本选项，或者在 NetBeans 生成的 Ant 脚本中覆盖目标。
所有编译和运行环境选项都是在 Ant 生成脚本中设置的。
IDE 为整个源文件夹生成一个 JAR 文件（对于 J2SE 项目）或 WAR 文件（对于 Web 项目）。
IDE 根据项目 Ant 脚本中指定的数量来生成相应数量的生成产品。
返回页首
从 NetBeans IDE 3.6 导入源代码
由于 NetBeans 4.0 项目结构与以前版本有很大的不同，因此未实现 NetBeans IDE 3.6 项目的自动导入功能。（由于在 NetBeans 3.6 中必须多次安装单个文件夹以访问应用程序所需的全部资源，因此 IDE 无法判断哪个安装点才是真正的源文件夹。）
要导入在 3.6 版本中使用的源代码，请为每个源包根目录创建一个新项目（或者，如果您有自己的 Ant 脚本，也可以为整个应用程序创建一个自由格式的项目）。有关将源代码导入 NetBeans IDE 4.0 的详细信息，请参见下列文档：
返回页首
导入 NetBeans IDE 3.6 设置
在首次运行 NetBeans IDE 4.0 时，尽管无法导入在 NetBeans IDE 3.6 中安装的文件夹及其关联设置，但可以导入许多常规 IDE 设置。无法导入 IDE 3.6 以前版本中的设置。
可从 NetBeans IDE 3.6 中导入下列设置：
要导入的设置
在 IDE 中的位置
Java 和源编辑器设置
所有文件类型的编辑器设置
工具 > 选项 > 编辑 > 编辑器设置 > <mime-type> 编辑器
源编辑器标注设置
工具 > 选项 > 编辑 > 标注类型
打印机设置
工具 > 选项 > IDE 配置 > 系统 > 打印设置
缩排引擎设置
工具 > 选项 > 缩排引擎
常规 Java 源代码设置
工具 > 选项 > 编辑 > Java 源代码
窗体编辑器设置
工具 > 选项 > 编辑 > 窗体编辑器设置
国际化设置
工具 > 选项 > 编辑 > 国际化
模板设置和定制模板
工具 > 选项 > 源创建和管理 > 模板
生成获取方法和设置方法
工具 > 选项 > 编辑 > Beans 属性
系统设置
代理信息和首选浏览器等系统设置
工具 > 选项 > 系统
常规快捷键
工具 > 快捷键
比较配置
工具 > 选项 > IDE 配置 > 服务器和外部工具设置 > 比较和合并类型
外部浏览器配置
工具 > 选项 > IDE 配置 > 服务器和外部工具设置 > Web 浏览器（在 IDE 选项对话框中）
HTTP 服务器设置
窗口 > 运行环境 > HTTP 服务器
保存的 HTTP 监视器事务
窗口 > HTTP 监视器 > 保存记录
服务器注册设置
窗口 > 运行环境 > 服务器注册
VCS 设置
常规 VCS 设置
工具 > 选项 > 源创建和管理 > 版本控制设置
VCS 组设置
工具 > 选项 > 源创建和管理 > 版本控制设置 > VCS 组设置
数据库设置
注册的 JDBC 驱动程序
窗口 > 运行环境 > 数据库 > 驱动程序
数据库连接和模块设置
工具 > 选项 > IDE 配置 > 服务器和外部工具设置 > 数据库资源管理器
返回页首
常见项目任务
下表说明如何在 NetBeans 4.0 中执行常见的项目任务：
执行此任务 请执行以下步骤
从现有源创建标准项目。
选择“文件”>“新建项目”(Ctrl-Shift-N)。
选择 "Web" >“包含现有源的 Web 项目”，或选择“常规”>“包含现有源的 Java 项目”。
按照向导中的其他说明进行操作。
从现有源和 Ant 脚本创建自由格式的项目。
选择“文件”>“新建项目”(Ctrl-Shift-N)。
选择 "Web" >“包含现有 Ant 脚本的 Web 项目”，或选择“常规”>“包含 Ant 脚本的 Java 项目”。
按照向导中的其他说明进行操作。
将 JAR 文件添加到标准项目的类路径中。
在“项目”窗口中，右键单击项目节点，然后选择“属性”。
单击“编译源”。
单击“添加 JAR/文件夹”，并在文件选择器中选择 JAR 文件。
设置项目之间的编译依存关系。
在“项目”窗口中，右键单击项目节点，然后选择“属性”。
单击“编译源”。
单击“添加项目”，然后选择相应项目（要添加到项目类路径中）的项目文件夹。注意：对于自由格式的项目，只需将项目的输出 JAR 文件添加到类路径中。
将 Javadoc 文档和源代码添加到类路径上的 JAR 文件中。
从主窗口中选择“工具”>“库管理器”。
如果尚未在库管理器中注册 JAR 文件，请使用“添加库”按钮创建一个新的空库。
在库管理器的左面板中选择该库。
在“类路径”标签中，单击“添加 JAR/文件夹”，然后指定包含已编译类文件的 JAR 文件的位置。一个库可以包含多个 JAR 文件。
可使用“源”和 "Javadoc" 标签来添加包含源代码和文档的文件夹或归档文件。
单击“确定”退出库管理器。
如果项目的编译类路径中没有 JAR 文件，请在类路径中添加该文件（如上所述）。
设置项目主类、执行参数、执行工作目录和 VM 参数。
在“项目”窗口中，右键单击项目节点，然后选择“属性”。
单击“运行项目”并输入相应信息。
定制生成步骤。
在“文件”窗口中，展开项目文件夹并打开 nbproject/build-impl.xml 和 nbproject/project.properties 。build-impl.xml 包含项目的所有处理指令。不要写入此文件，因为 IDE 将覆写对它所做的任何更改。
查找生成目标和属性，它们控制要更改的生成步骤。每个主要生成目标都有一个 pre 和 post 目标，您可以在执行目标前后覆盖这些目标以添加指令。
在项目文件夹中双击 build.xml ，并覆盖来自 build-impl.xml 的任何目标。
编辑 project.properties 中的任何生成属性。如果您要共享项目元数据，但不希望共享某个设置，请在 nbproject/private/private.properties 中覆盖它。
设置生成输出文件夹。
在“文件”窗口中，展开项目文件夹中的 nbproject 节点。
双击 project.properties 在源编辑器中将其打开。
在 build.dir 属性中设置生成输出文件夹。如果在项目文件夹的外部设置生成输出文件夹，则在“文件”窗口中将无法访问它。注意：每次清除项目时，都会删除生成输出文件夹。因此，不应将生成输出文件夹设置为源文件夹。
返回页首
