创建 Java 类库项目

1. 选择 "File"（文件）> "New Project"（新建项目）(Ctrl-Shift-N)。在 "Categories"（类别）下，选择 "Java"。在 "Projects"（项目）下选择 "Java Class Library"（Java 类库）。单击 "Next"（下一步）。
2. 在 "Project Name"（项目名称）下，键入 MyLib。将项目位置更改为计算机上的任意目录。从现在起，本教程将此目录称为 NetBeansProjects。

   注意：上面指定的路径在向导的 "Project Folder"（项目文件夹）字段中应显示如下：/NetBeansProjects/MyLib/

3. （可选）选中 "Use Dedicated Folder for Storing Libraries"（使用专用文件夹存储库）复选框，并指定库文件夹的位置。有关此选项的详细信息，请参见共享项目库。
4. 单击 "Finish"（完成）。将同时在 "Pojects"（项目）窗口和 "Files"（文件）窗口中打开 MyLib 项目。

创建 Java 应用程序项目

1. 选择 "File"（文件）> "New Project"（新建项目）。在 "Categories"（类别）下，选择 "Java"。在 "Pojects"（项目）下，选择 "JAve Application"（Java 应用程序）。单击 "Next"（下一步）。
2. 在 "Project Name"（项目名称）下，键入 MyApp。确保将 "Project Location"（项目位置）设置为 NetBeansProjects。
3. （可选）选中 "Use Dedicated Folder for Storing Libraries"（使用专用文件夹存储库）复选框。
4. 输入 acrostic.Main 作为主类。
5. 确保选中 "Set as Main Project"（设置为主项目）和 "Create Main Class"（创建主类）复选框。
6. 单击 "Finish"（完成）。在 "Projects"（项目）窗口中显示 MyApp 项目，并在源代码编辑器中打开 Main.java。

配置编译类路径

由于 MyApp 将依赖于 MyLib 中的类，因此您必须在 MyApp 的类路径中添加 MyLib。执行此操作还可确保 MyApp 项目中的类可以引用 MyLib 项目中的类，而不会导致编译错误。此外，您也可以通过此操作在 MyApp 项目中使用代码完成功能填写基于 MyLib 项目的代码。在 IDE 中，类路径由 "Libraries"（库）节点直观表示。

在项目类路径中添加库的实用程序类：

1. 在 "Pojects"（项目）窗口中，右键单击 MyApp 项目的 "Libraries"（库）节点，然后选择 "Add Project"（添加项目），如下图所示。

   

2. 浏览到 NetBeansProjects/，然后选择 MyLib 项目文件夹。“项目 JAR 文件”窗格显示了可以添加到项目中的 JAR 文件。请注意，系统将列出 MyLib 的 JAR 文件，即使您尚未实际生成 JAR 文件也是如此。在生成并运行 MyApp 项目时，将生成此 JAR 文件。
3. 单击 "Add Project JAR Files"（添加项目 JAR 文件）。
4. 展开 "Libraries"（库）节点。MyLib 项目的 JAR 文件将被添加到 MyApp 项目的类路径中。

创建 Java 包和类文件

1. 右键单击 MyLib 项目节点，然后选择 "New"（新建）> "Java Class"（Java 类）。键入 LibClass 作为新类的名称，在 "Package"（包）字段中键入 org.me.mylib，然后单击 "Finish"（完成）。LibClass.java 在源代码编辑器中打开。
2. 在 LibClass.java 中，将光标置于类声明 (public class LibClass {) 后面的行上。
3. 键入或粘贴以下方法代码：
   

       public static String acrostic(String[] args) {
           StringBuffer b = new StringBuffer();
           for (int i = 0; i < args.length; i++) {
               if (args[i].length() > i) {
                   b.append(args[i].charAt(i));
               } else {
                   b.append('?');
               }
           }
           return b.toString();
                   }

4. 如果粘贴的代码格式不正确，请按 Alt-Shift-F 组合键重新设置整个文件的格式。
5. 按 Ctrl-S 组合键保存该文件。

编辑 Java 文件

现在您将向 Main.java 中添加一些代码。在执行此操作的过程中，您会看到源代码编辑器的代码完成和代码模板（缩写）功能。

1. 在源代码编辑器中选择 "Main.java" 标签。如果尚未打开该标签，请在 "Projects"（项目）窗口中展开 "MyApp" > "Source Packages"（源包）> "acrostic"，然后双击 "Main.java"。
2. 删除 main 方法中的 // TODO code application logic here 注释。
3. 键入下列代码，以代替该注释：

   String result = Li

   将光标保留在紧随 Li 之后的位置。在下一步中，您将使用代码完成功能来将 Li 转换为 LibClass。

4. 按 Ctrl-空格键打开代码完成框。

   将显示一个简短的列表，其中列出了用于完成该词的可能方式。但是，该列表中可能不会列出您所需的类 LibClass。

5. 再次按 Ctrl-空格键以显示较长的可能匹配项列表。

   此列表中应该包含 LibClass。

6. 选择 "LibClass"，然后按 Enter 键。IDE 将填写该类名的其余部分，并且还将自动为该类创建一个 import 语句。

   注意：IDE 还将在代码完成框的上面打开一个框，该框显示选定类或包的 Javadoc 信息。由于此包没有对应的 Javadoc 信息，因此该框将显示 "Cannot find Javadoc"“无法找到 Javadoc”消息。

7. 在主方法中 LibClass 后面键入句点 (.)。将再次打开代码完成框。
8. 选择 "acrostic(String[]args)" 方法，然后按 Enter 键。IDE 将填写 acrostic 方法并突出显示 args 参数。
9. 按 Enter 键以接受 args 参数。
10. 键入分号 (;)。

    最后一行应与以下行类似。

    String result = LibClass.acrostic(args);

11. 按 Enter 键以开始一个新行。然后，键入 sout 并按 Tab 键。sout 缩写将扩展为 System.out.println("");，且光标置于引号之间。在引号内键入 Result =，并在右引号后面键入 + result。

    最后一行应与以下行类似。

    System.out.println("Result = " + result);

12. 按 Ctrl-S 组合键保存该文件。

注意：sout 是源代码编辑器中许多可用的代码模板之一。要查找和编辑代码模板的列表，请选择 "Tools"（工具）> "Options"（选项）> "Editor"（编辑器）> "Code Template"（代码模板）。

设置主类和执行参数

此程序的输出基于您在运行程序时提供的参数。您将提供五个词作为参数，然后通过这五个词生成离合词 "Hello"。离合词是由第一个词的第一个字母、第二个词的第二个字母、第三个词的第三个字母，依此类推组合而成的。

添加 IDE 在运行应用程序时使用的参数：

1. 右键单击 MyApp 项目节点，选择 "Properties"（属性），然后选择对话框左窗格中的 "Run"（运行）节点。

   主类应该已设置为 acrostic.Main。

2. 在 "Arguments"（参数）字段中键入 However we all feel zealous，然后单击 "OK"（确定）。

运行应用程序

现在您已创建了应用程序并为该应用程序提供了运行时参数，接下来便可以在 IDE 中测试运行应用程序。

在 IDE 中运行应用程序：

• 选择 "Run"（运行）> "Run Main Project"（运行主项目）(F6)。

  在 "Output"（输出）窗口中，您应该看到程序的输出 Result = Hello（作为参数传递到程序的短语的离合词）。

创建 JUnit 测试

1. 在 "Pojects"（项目）窗口中右键单击 "LibClass.java" 节点，然后选择 " Tools"（工具）> "Create JUnit Tests"（创建 JUnit 测试）(Ctrl-Shift-U)。

   如果这是您首次在 IDE 中创建 JUnit 测试，则系统会显示 "Select JUnit Version"（选择 JUnit 版本）对话框提示。按 Enter 键以选择 "JUnit 4.x"，然后继续执行 "Create Tests"（创建测试）对话框中的操作。

2. 在 "Create Tests"（创建测试）对话框中，单击 "OK"（确定）以使用缺省选项运行命令。IDE 在单独的 test 文件夹中创建 org.me.mylib 包和 LibClassTest.java 文件。通过展开 "Test Packages"（测试包）节点和 org.me.mylib 子节点，可以找到此文件。
3. 在 LibClassTest.java 中，删除 public void testAcrostic() 方法的主体。
4. 键入或粘贴以下代码，以代替删除的行：
   

   System.err.println("Running testAcrostic...");
   String result = LibClass.acrostic(new String[]
                     {"fnord", "polly", "tropism"});
                   assertEquals("Correct value", "foo", result);

5. 通过按 Ctrl-S 组合键保存该文件。

运行 JUnit 测试

1. 选择 MyLib 项目节点，然后选择 "Run"（运行）> "Test Project (MyLib)"（测试项目 (MyLib)）或按 Alt-F6 组合键。"MyLib (test)" 标签在 "Output"（输出）窗口中打开。同时，将编译并运行 JUnit 测试用例。“JUnit 测试结果”显示测试是否通过。
2. 您还可以运行单个测试文件，而不是测试整个项目。在源代码编辑器中选择 "LibClass.java" 标签，然后选择 "Run"（运行）> "Test File"（测试文件）。

可以从 IDE 中获取 JUnit API 文档。选择 "Help"（帮助）> "Javadoc References"（Javadoc 参考）> "JUnit VersionNumber"（JUnit <版本号>）。

通过访问 http://www.junit.org，可以了解有关 JUnit 的详细信息。

调试应用程序

在此部分，您将使用调试器来逐步执行应用程序，并观察在组合离合词时变量值的变化情况。

在调试器中运行应用程序：

1. 在 LibClass.java 文件中，转至 acrostic 方法，并在 b.append(args[i].charAt(i)); 内部的任何位置放入插入点。然后，按 Ctrl-F8 组合键设置断点。
2. 选择 "Debug"（调试）> "Debug Main Project"（调试主项目）(Ctrl-F5)。IDE 将打开调试器窗口并在调试器中运行该项目，直至到达断点为止。
3. 选择 IDE 底部的 "Local Variables"（局部变量）窗口，然后展开 "args" 节点。字符串数组包含您输入的作为命令参数的短语。
4. 按 F7 键（或选择 "Debug"（调试）> "Step Into"（步入））以逐步执行程序，同时观察构建离合词时 b 变量的变化情况。

   在程序结束时，调试器窗口会关闭。

有关详细信息，请参见在 NetBeans IDE 中编写 JUnit 测试。

生成应用程序

IDE 中的主生成命令是 "Clean and Build"（清理并生成）命令。"Clean and Build"（清理并生成）命令可以删除以前编译的类和其他生成工件，然后从头开始重新生成整个项目。

注意：还有一个 "Build"（生成）命令，该命令不会删除旧的生成工件，但此命令缺省情况下处于禁用状态。有关详细信息，请参见创建、导入和配置 Java 项目指南的“在保存时编译”部分。

生成应用程序：

• 选择 Run"（运行）> "Clean and Build Main Project"（清理并生成主项目）(Shift-F11)。

此时 Ant 生成脚本中的输出会显示在 "Output"（输出）窗口中。如果未显示 "Output"（输出）窗口，则可以通过选择 "Window"（窗口）> "Output"（输出）> "Output"（输出）手动打开该窗口。

清理并生成项目时，会出现以下情况：

• 删除（“清理”）由以前的生成操作所生成的输出文件夹。（大多数情况下，这些文件夹为 build 和 dist 文件夹。）
• 将 build 和 dist 文件夹添加到项目文件夹（以下称为 PROJECT_HOME 文件夹）中。您可以在 "Files"（文件）窗口中查看这些文件夹。
• 将所有源都编译成 .class 文件，并将这些文件放置在 PROJECT_HOME/build 文件夹中。
• 在 PROJECT_HOME/dist 文件夹中创建包含项目的 JAR 文件。
• 如果您已为该项目指定了任何库（除了 JDK 之外），则在 dist 文件夹中将创建一个 lib 文件夹。这些库将被复制到 dist/lib 中。
• JAR 中的清单文件更新后将包括用于指定主类的条目以及项目的类路径中的所有库。

注意：您可以在 IDE 的 "Files"（文件）窗口中查看清单的内容。生成项目后，请切换到 "Files"（文件）窗口并导航至 dist/MyApp.jar。展开 JAR 文件的节点，展开 "META-INF" 文件夹，然后双击 "MANIFEST.MF" 以便在源代码编辑器中显示清单。

Main-Class: acrostic.Main
            Class-Path: lib/MyLib.jar

（要查找有关清单文件的详细信息，请参阅《Java 教程》中的本章。）

在 IDE 外部运行应用程序

在 IDE 外部运行应用程序：

1. 在系统上，打开命令提示符或终端窗口。
2. 在命令提示符下，将目录更改为 MyApp/dist 目录。
3. 在命令行中，键入以下语句：

                   java -jar MyApp.jar However we all feel zealous    

随后，将执行应用程序并返回以下输出，如下图所示：

Result = Hello
            

将应用程序分发给其他用户

现在您已验证了应用程序能够在 IDE 外部运行，接下来便可以分发该应用程序。

分发应用程序：

1. 在您的系统上，创建一个 zip 文件，该文件包含应用程序 JAR 文件 (MyApp.jar)，并附带包含 MyLib.jar 的 lib 文件夹。
2. 将该文件发送给要使用该应用程序的人员。指示他们解压缩该 zip 文件，并确保 MyApp.jar 文件和 lib 文件夹位于同一个文件夹中。
3. 指示用户按照上面的在 IDE 外部运行应用程序部分中的步骤进行操作。

使 Javadoc 在 IDE 中可用

要在 NetBeans IDE 中查看 JavaSE API 文档，请使用 "Source"（源）> "Show Documentation"（显示文档）命令，或者从主菜单中选择 "Window"（窗口）> "Other"（其他）> "Javadoc"，以便在单独窗口中查看 API 文档。

不过，对于某些第三方库，则无法使用 API 文档。在这些情况下，必须手动将 Javadoc 资源与 IDE 相关联。

要使 API 文档可用于“显示 Javadoc”命令，请执行以下操作：

1. 下载 Javadoc API 文档源文件。
2. 选择 "Tools"（工具）> "Libraries"（库）。
3. 在 "Libraries"（库）列表中，选择项目所使用的库。
4. 单击 "Javadoc" 标签。
5. 单击 "Add ZIP/Folder"（添加 ZIP/文件夹）按钮，然后导航至系统上包含 Javadoc API 文档的 zip 文件或文件夹。选择该 zip 文件或文件夹，然后单击 "Add ZIP/Folder"（添加 ZIP/文件夹）按钮。
6. 单击 "Close"（关闭）。

为项目生成 Javadoc

您可以根据添加到类中的 Javadoc 注释为项目生成已编译的 Javadoc 文档。

为项目生成 Javadoc 文档：

1. 选择 MyLib 项目。
2. 从 IDE 主菜单中选择 "Run"（运行）> "Generate Javadoc for "MyLib""（为 "MyLib" 生成 Javadoc）。
   生成的 Javadoc 将被添加到项目的 dist 文件夹中。此外，IDE 还将打开一个 Web 浏览器，用于显示 Javadoc。