将现有应用程序导入到 NetBeans IDE 中 — 概念

项目类型比较

源文件夹

在添加包含源代码的文件夹时，必须添加包含包树中最高层文件夹的文件夹 - 例如，对于 com.jcardshark.blackjack.ui 包，应添加包含 com 文件夹的文件夹。

标准。在每个项目中，只能有一个源文件夹和一个 JUnit 测试文件夹。要使用多个源文件夹，可以为每个源文件夹创建一个项目，然后根据需要将项目放到彼此的类路径中。

自由格式。可以使用多个源文件夹，并在文件夹之间定义复杂的类路径关系。源文件夹可位于磁盘上的任意位置，并可在创建项目后添加和删除这些文件夹。

项目文件夹

项目文件夹包含 Ant 脚本和属性文件，这些文件控制项目的生成和运行方式。

标准。项目文件夹包含两种 Ant 脚本：

• nbproject/build-impl.xml。包含有关项目处理的说明。此文件是由 IDE 生成的，不应对其进行编辑。
• build.xml。从 build-impl.xml 导入目标。您可以对此文件进行编辑，以覆盖现有目标或创建新的目标。

项目文件夹还包含已编译类的输出文件夹、JAR 文件（对于 J2SE 项目）或 WAR 文件（对于 Web 项目）以及 Javadoc。

自由格式。在自由格式的项目中指定“位置”时，此位置不必是包含 Ant 脚本的文件夹。例如，如果将所有源包文件夹组织到一个文件夹中，您可以将该文件夹设置为项目位置，即使它不包含 Ant 生成脚本。输出文件夹的位置取决于 Ant 脚本的配置方式。

Web 模块根目录

Web 模块根目录是 Web 应用程序的顶层文件夹。JSP 页、客户端类和归档文件以及静态 Web 资源（如图像）均存储在该文件夹中。下图显示了一个典型 Web 应用程序的源结构。

主项目

在将应用程序组织为多个项目时，主项目将用作应用程序的入口点。通常，主项目包含用来启动应用程序的主类。许多菜单命令（如“运行”和“生成”）都有主项目的快捷键。也可以通过在“项目”窗口中右键单击各项目的节点，来访问这些项目的所有命令。

要使某一项目成为主项目，请在“项目”窗口中右键单击该项目的节点，然后选择“设置为主项目”。

将命令链接到 Ant 目标

自由格式的项目依赖于 Ant 脚本来为所有 IDE 操作提供目标，这些操作包括：

• 生成
• 清除
• 编译项目
• 编译单个文件
• 编译 JavaServer Pages 文件
• 运行项目
• 运行单个文件
• 生成 Javadoc
• 运行 JUnit 测试
• 在调试器中运行项目
• 在调试器中运行单个文件
• 修复并继续
• 重新部署 Web 项目

如果 Ant 脚本不包含其中任何操作的目标，则在 IDE 中禁用这些命令。您可以轻松地为这些命令编写目标，然后在项目的“项目属性”对话框中将其与命令关联起来。

如果您无法对 Ant 脚本进行编辑以包括新目标，则可以编写一个包含这些目标的辅助 Ant 脚本。有关详细信息，请参见高级自由格式项目配置。

“项目”窗口和“文件”窗口

“项目”窗口显示基于包的项目视图。您可以右键单击项目节点，来为该项目运行命令。可以通过右键单击项目节点并选择“属性”来配置项目选项。

“文件”窗口显示磁盘中项目文件的物理布局。将为每个项目显示项目文件夹和各个源文件夹。nbproject 文件夹包含项目的项目元数据。

设置类路径

标准。将类添加到项目的类路径后，IDE 将这些类用于代码完成和重构。可以将下列类型的类路径元素添加到项目中：

• JAR 文件。已编译的 Java 类的包装库（仅限 J2SE 项目）。
• WAR 文件。已编译的 Web 类的包装库（仅限 Web 项目）。
• 库。已编译的类的集合（JAR/WAR 文件）、用于调试的源代码以及 Javadoc。可通过从主窗口中选择“工具”>“库管理器”来创建库。
• 项目。生成输出（JAR/WAR 文件）、用于调试的源代码以及来自其他 NetBeans IDE 项目的 Javadoc。如果在某个项目中添加了一个必需项目，则在生成主项目时，将生成这两个项目的所有 JAR/WAR 文件。（在 J2SE 示例中，在生成 BlackJackUI 的同时，还会生成必需项目 BlackJackLib。）

自由格式。Ant 脚本必须明确处理用于编译和执行的类路径元素。在创建项目时输入的类路径设置用于为项目提供代码完成、错误突出显示和重构功能。这些类路径设置必须与 Ant 脚本中的类路径定义相匹配。您可以为整个项目设置一个类路径，也可以为项目中的各个源文件夹分别设置类路径。要为现有的自由格式项目声明类路径，请在“项目”窗口中右键单击该项目节点并选择“属性”。然后单击“类路径”，并为每个源根目录设置类路径。

设置上下文路径

可以通过上下文，将某个 Web 应用程序中的资源与同一服务器实例上部署的其他 Web 应用程序中的资源区分开来。

应用程序上下文确定 Web 应用程序内容的 URL 名称空间。设置了 Web 应用程序的上下文属性值后，即可访问位于 http://hostname:port/context/servlet_or_jsp 的 Web 模块。例如，在将属性值设置为 /HelloWeb 后，即可访问位于 http://hostname:port/HelloWeb/index.jsp 的 Web 应用程序。