将现有的 Java 源代码导入到 NetBeans IDE 5.0 中

本文档介绍了如何在 NetBeans IDE 项目中导入现有源代码。第一个方案概述了使用标准 Java 项目时完成此任务所需的步骤;而第二个方案则描述了使用自由格式的 Java 项目(这些项目使用现有的 Ant 脚本)时完成此任务的过程。在这两个方案中,我们都将引用一个假想的 BlackJack 示例项目,说明如何在 NetBeans IDE 中设置应用程序代码。

使用以下两个项目模板可以导入现有的 J2SE 源代码:

使代码开始工作

假想的 BlackJack 应用程序由三个包组成:com.jcardshark.blackjack.ui、com.jcardshark.blackjack.lib 和 resources。在本教程中,我们假定这三个包位于 JavaGames 文件夹下的 BlackJack 文件夹中。下面的屏幕快照以图解方式说明了假想的目录树。另请注意,Libraries 文件夹包含一个名为 jcardshark-core.jar 的 JAR 文件,需要将此文件放在 com.jcardshark.blackjack.ui 和 com.jcardshark.blackjack.lib 包的类路径上。

显示 BlackJack 项目的源文件夹布局的标准资源管理器窗口


使用 IDE 生成、运行和调试:标准项目

在开始之前,我们将创建一个用作 BlackJackUI 应用程序主入口点的主项目。此项目包含两个源根目录。然后再创建一个相关项目,用于存储应用程序必需的 BlackJackLib 源。接下来,我们将附加库和 BlackJackLib 项目自身添加到 BlackJackUI 项目的类路径中。最后,通过运行此应用程序来测试我们所做的工作。

使用多个源根创建项目

  1. 选择 File > New Project (Ctrl-Shift-N)。
  2. 选择 General > Java Project with Existing Sources。单击 Next。
  3. 在 Project Name 字段中,键入 BlackJackUI。请注意,IDE 会自动建议将此名称用作项目文件夹的名称。
  4. 单击 Project Folder 字段旁边的 Browse 按钮,在系统中的某个位置创建一个名为 NetBeans_projects 的文件夹来保存 NetBeans 项目。然后选择新建的 NetBeans_projects 文件夹,确保选中了 Set as Main Project 框,并单击 Next。

    注意: 上面指定的路径应如下所示:NetBeans_projects/BlackJackUI

  5. 在 Source Packages Folder 窗格中,单击 Add Folder,找到 JavaGames/BlackJack/BlackJackUI 文件夹,然后选择 resources 和 src 文件夹
  6. (可选)在 Test Packages Folder 窗格中,单击 Browse 以选择包含 JUnit 包文件夹的文件夹。由于 BlackJack 项目不包含任何 JUnit 测试,因此可以跳过此步骤。
  7. 单击 Finish。

    BlackJackUI 项目将同时显示在 Projects 窗口和 File 窗口中。

创建相关项目

  1. 选择 File > New Project (Ctrl-Shift-N)。
  2. 选择 General > Java Project with Existing Sources。单击 Next。
  3. 在 Project Name 字段中,键入 BlackJackLib。
  4. 单击 Project Folder 字段旁边的 Browse 按钮,找到先前创建的 NetBeans_projects 文件夹。确保未选中 Set as Main Project,然后单击 Next。

    注意: 上面指定的路径应如下所示:NetBeans_projects/BlackJackLib

  5. 在 Source Packages Folder 窗格中,单击 Add Folder,找到 JavaGames/BlackJack/BlackJackLib 目录,然后选择 src 文件夹。
  6. 单击 Finish。

    将在 Projects 窗口和 File 窗口中显示新的 BlackJackLib 项目以及 BlackJackUI 项目(如下所示)。

管理项目类路径

此时,我们需要将位于 /JavaGames/Libraries/ 文件夹中的附加库同时添加到 BlackJackLib 相关项目和 BlackJackUI 主项目中。

  1. 在 Projects 窗口中,右键单击 BlackJackLib 项目的 Libraries 节点,然后选择 Add JAR/Folder。
  2. 选择 JavaGames/Libraries/jcardshark-core.jar,然后单击 Open。此时会将 JAR 文件添加到项目的类路径中。
  3. 重复步骤 1 至 2,将 JavaGames/Libraries/jcardshark-core.jar 添加到 BlackJackUI 项目的类路径中。

现在,我们将 BlackJackLib 项目自身添加到 BlackJackUI 项目的类路径中。

  1. 右键单击 BlackJackLib 项目的 Libraries 节点,然后选择 Add Project。
  2. 找到 NetBeans_projects 文件夹,然后选择 BlackJackLib 项目文件夹。
  3. 现在,项目应如下所示。

运行应用程序

  1. 选择 Run > Run Main Project 来运行应用程序。
  2. 在出现的对话框中,将 BlackJack.java 设置为主类。

使用您自己的 Ant 脚本编译、运行和调试:自由格式项目

如果您拥有自己的 build.xml 文件,则可以为应用程序创建自由格式项目。在自由格式项目中,必须手动将所需的任何 Ant 目标链接到相应的 IDE 命令,并设置项目的源文件夹,才能生成、运行和调试项目。现在我们来了解一下如何为 BlackJack 应用程序使用包含现有 Ant 脚本的自由格式项目。

正如前面的示例一样,我们首先需要创建存放应用程序和必需源的项目。接下来,我们将映射 Ant 目标(以便为应用程序调用 IDE 命令),并通过添加必需的源并指定应用程序的源代码级别,来配置项目的类路径。最后,我们将通过生成和运行项目来测试应用程序。

创建自由格式项目

  1. 选择 File > New Project (Ctrl-Shift-N)。
  2. 选择 General > Java Project with Existing Ant Script。单击 Next。
  3. 在向导的 Name and Location 页中,单击 Location 字段旁边的 Browse 按钮,然后选择 JavaGames/BlackJack 文件夹。请注意,IDE 会自动建议将此文件夹用作新项目文件夹的位置。由于位置文件夹还包含项目的生成脚本,因此 IDE 将自动提取生成脚本位置。
  4. 在 Project Name 字段中输入 BlackJack,确保选中了 Set as Main Project 复选框,然后单击 Next。

将 Ant 目标与 IDE 命令链接在一起

  1. 在向导的 Build and Run Actions 页中,指定 IDE 应为项目命令运行哪些目标。
    注意:将 Generate Javadoc 和 Test Project 保持为空,因为 Ant 脚本不包含这些命令的目标。为这些命令编写目标之前,在 IDE 中将无法使用它们。
  2. 填写完其他目标字段后,单击 Next。

配置源文件夹

  1. 在向导的 Source Packages Folder 页中,单击 Add Folder,找到 /JavaGames/ 文件夹,然后将 BlackJackLib/srcBlackJackUI/srcBlackJackUI/resources 文件夹添加到项目中。
  2. 在 Source Level 组合框中,选择在编译和运行应用程序时要使用的 JDK 版本。单击 Next。
  3. 在向导的 Java Sources Classpath 页中,从 Source Packages Folder 组合框中选择 /BlackJackLib/src。然后单击 Add JAR/Folder,将 jcardshark-core.jar 添加到源文件夹的类路径中。
  4. 在 Source Packages Folder 组合框中选择 /BlackJackUI/src,然后将 BlackJackUI/resourcesBlackJackLib/srcjcardshark-core.jar 添加到源文件夹的类路径中。
    注意:此类路径并不用于编译或执行,Ant 脚本会处理这些任务的类路径。这些设置只用于通知 IDE 将哪些类包括在代码完成和重构中。
  5. 单击 Finish。

    BlackJackUI 项目将同时显示在 Projects 窗口和 File 窗口中,如下图所示。


    The free-form BlackJack project's layout as shown in the IDE's Projects window and Files window.

运行程序

  • 选择 Run > Run Main Project 来运行应用程序。
    注意:项目的 Ant 脚本必须有一个用于运行应用程序的目标。

后续步骤

有关使用 NetBeans IDE 5.0 的详细信息,请参见以下资源:

 
 

相关文档

该指南介绍了如何快速地创建、生成和执行简单的 J2SE 应用程序。
IDE 的简要用户指南,该指南包含有关一般 IDE 功能的有用信息,这些功能用于创建项目、编辑文件、编译、调试、集成版本控制等。
该指南简要介绍了如何将现有的 Web 应用程序导入到 NetBeans IDE 5.0 中。
该指南简要介绍了如何将现有的企业应用程序和 EJB 模块导入到 NetBeans IDE 5.0 中。
该指南简要介绍了如何将现有的 J2ME 平台源代码导入到 NetBeans IDE 5.0 中。
介绍了如何进一步配置自由格式项目,以便将 IDE 与您公司的生成过程完全集成在一起。
NetBeans IDE 5.0 的完整文档列表。