NetBeans IDE 4.1 快速入门指南

下面的简要教程介绍了在 NetBeans IDE 4.1 中开发 J2SE 应用程序的一些基本步骤。我们将创建一个具有实用程序类的 MyLib 项目，然后创建一个具有主类的 MyApp 项目(该主类将在库项目中实现一种方法)。本文档旨在帮助您尽快入门。

　　样例项目

　　您只想试用某些项目吗?在 IDE 中，选择“文件”>“新建项目”，然后查看“样例”文件夹。IDE 包括一些样例项目以帮助您熟悉 IDE，这些项目可用作 Web 和企业项目以及常规项目。

　　设置项目

　　首先，我们创建一个新的 Java 类库以包含稍后需要使用的实用程序类。然后，我们需要创建一个新的 Java 应用程序以用作主项目。在创建了 MyApp 项目后，我们将 MyLib 的类添加到其类路径中。

　　创建新的 Java 类库

　　1  选择“文件”>“新建项目”(Ctrl-Shift-N)。在“类别”下选择“常规”。在“项目”下选择“Java 类库”，然后单击“下一步”。

　　2  在“项目名称”下输入 MyLib。将“项目位置”更改为计算机中的任意目录。从现在开始，我们将此目录称为 NetBeans_projects。

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

　　3  单击“完成”。IDE 将在系统中创建 NetBeans_projects/MyLib 文件夹。此文件夹包含所有的源和项目元数据(如项目 Ant 脚本)。

　　MyLib 项目将同时在“项目”窗口和“文件”窗口中被打开。

　　创建新的 Java 应用程序

　　1  选择“文件”>“新建项目”。在“类别”下选择“常规”。在“项目”下选择“Java 应用程序”，然后单击“下一步”。

　　2  在“项目名称”下输入 MyApp。确保将“项目位置”设置为 NetBeans_projects。

　　3  输入 acrostic.Main 作为主类。

　　4  确保选中了“设置为主项目”和“创建主类”复选框。单击“完成”。

　　IDE 将创建 NetBeans_projects/MyApp 文件夹。在“项目”窗口中将显示 MyApp 项目，并在源编辑器中打开 Main.java。

　　配置编译类路径

　　1  在“项目”窗口中右键单击 MyApp 项目，然后选择“属性”。

　　2  在对话框的左窗格中选择“库”节点。然后选择“编译”标签并单击“添加项目”。

　　3  找到 NetBeans_projects/ 并选择 MyLib 项目文件夹。“项目 JAR 文件”窗格将显示可添加到项目中的 JAR 文件。请注意，即使我们尚未实际生成 JAR 文件，该窗格也会为 MyLib 列出一个 JAR 文件。此 JAR 文件是在我们生成和运行 MyApp 项目时生成的。

　　4  单击“添加项目 JAR 文件”，然后单击“确定”关闭“项目属性”对话框。

　　此时，会将 JAR 添加到 MyApp 项目的编译时库列表中。

创建和编辑 Java 源代码

　　现在，我们需要创建 Java 包并添加用于构造 acrostic 的方法，然后在 Main 类中实现 acrostic 方法。

　　创建 Java 包和类文件

　　1  展开 MyLib 项目节点。

　　2  右键单击“源包”节点，然后选择“新建”>“Java 类”。为新类输入名称 LibClass，在“包”字段中键入 org.me.mylib，然后单击“完成”。此时将在源编辑器中打开 LibClass.java。

　　3  在 LibClass.java 中，将光标放在类声明 (public class LibClass {) 和构造函数 (public LibClass() {) 之间的行中。键入或粘贴以下方法代码:

    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  如果粘贴的代码未正确设置格式，请按 Ctrl-Shift-F 组合键重新设置整个文件的格式。

　　5  按 Ctrl-S 组合键保存文件。

　　编辑 Java 文件

　　1  在源编辑器中选择 Main.java 标签。

　　2  在 main 方法中删除 // TODO code application logic here 注释，然后键入以下内容:

String result = Li

　　3  按 Ctrl-空格键打开代码完成框。IDE 将为项目编译类路径中的所有类和方法提供代码完成。选择LibClass ，然后按 Enter 键。IDE 填充类名的其余部分，并且还会自动为类创建一个 import 语句。

　　注意:IDE 还会在代码完成框上面打开一个框，它可为选定的类或包显示 Javadoc 信息。由于大多数包没有 Javadoc 信息，因此，在到达 Java 类之前，此框一直显示 "Cannot find Javadoc" 消息。

　　4  在 main 方法中，在以下类后面输入一个句点:LibClass. 将重新打开代码完成框。选择 acrostic(String[]args) 方法及其缺省参数 args，然后按 Enter 键。如果可用，将会打开 Javadoc 查看器，可以在其中查看方法的弹出信息。接下来，在右圆括号后面键入分号。最后一行应该如下所示:

String result = LibClass.acrostic(args);

　　5  按 Enter 键开始新的一行。然后，键入 sout 并按空格键。sout 缩写将扩展为 System.out.println("");，并且光标位于引号之间。在引号内键入 Result =，并在引号后键入 + result。最后一行应该如下所示:

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

　　重构

　　现在我们已创建了应用程序，让我们来了解一下 IDE 的重构功能，可以使用这些功能来查找、重定位甚至自动重命名类。

　　查找类名的使用实例

　　1  在“项目”窗口中，展开 "MyLib" >“源包”> "org.me.mylib" > "LibClass.java" > "LibClass" >“方法”。

　　2  右键单击 acrostic 方法，选择“查找使用实例”(Alt-F7)，然后单击“下一步”。结果将显示在 IDE 底部的“使用实例”窗口中。

　　3  在“使用实例”窗口中双击任一结果，可跳转到它在源编辑器中的位置。

把类移到不同的包中

　　1  在“项目”窗口中，再次右键单击 MyApp 项目的“源包”节点，然后选择“新建”>“Java 包”。将包命名为 org.me.myapp，然后单击“完成”。

　　2  将 Main.java 节点从 acrostic 包拖放到 org.me.myapp 包中。此时将出现“为已移动的类重构代码”对话框，询问您是否将该类的所有引用更改为指向新包。

　　3  单击“下一步”继续进行重构。通过“重构”窗口可以预览将更改为指向新包的所有引用。双击任一引用，可跳转到它在源编辑器中的位置。可以取消选择任一引用旁边的复选框，将该引用从重构中排除。

　　4  在“重构”窗口的左下角，单击“进行重构”。

　　IDE 将更新 Main.java 中的包语句。

　　重命名类

　　1  在源编辑器中选择 Main.java 标签。

　　2  在类声明的第 15 行或其附近的行中右键单击 Main 一词，然后选择“重构”>“重命名”。

　　3  在“新名称”字段中，写入 AcrosticExample。然后单击“下一步”。

　　4  单击“进行重构”按钮。

　　此时，IDE 将重命名类及其所有引用。

　　撤消重构

　　1  选择“重构”>“撤消 [重命名]”。

　　2  选择“重构”>“重做 [重命名]”。

　　编译和运行项目

　　现在，我们需要设置主类和执行参数以运行项目。我们还要了解一下 IDE 的清除、生成以及 Javadoc 生成功能。

　　设置主类和执行参数

　　1  右键单击 MyApp 项目节点，选择“属性”，然后在对话框左窗格中选择“运行”节点。请注意，acrostic.Main 将出现在“主类”字段中。由于我们已重命名了该主类并将其放在另一个包中，因此必须输入新的类名作为主类。

　　2  单击“浏览”按钮并选择 org.me.myapp.AcrosticExample。然后单击“选择主类”。

　　3  在“参数”字段中输入 However we all feel zealous，然后单击“确定”。

　　运行主项目

　　1  从“运行”菜单中选择“运行”>“运行主项目”(F6)。双击“输出”窗口将其最大化，以便可以看到所有输出。请注意，Ant 先生成 MyLib.jar ，然后再使用它来编译 MyApp。最后，Ant 将打印程序的输出结果:Result = Hello (短语的离合诗，作为参数传递给程序)。

　　2  选择“文件”窗口并展开 MyApp 项目文件夹。生成的类文件位于 build 文件夹中。

　　3  按 F6 键再次运行程序。但这次只是运行程序，并不需要编译任何新内容。

　　清除并生成项目

　　1  选择“生成”>“清除并生成主项目”(Shift-F11)。将同时清除 MyLib 项目和 MyApp 项目，然后将其作为进程的一部分重新生成。

　　2  在“项目”窗口中右键单击 MyLib 项目节点，然后选择“清除项目”。仅清除 MyLib 项目。

　　生成单独的项目

　　1  在“项目”窗口中，右键单击 MyLib 项目节点。

　　2  从上下文菜单中选择“生成项目”。

生成 Javadoc

　　1  选择 MyLib 项目。

　　2  从 IDE 的主菜单中，选择“生成”>“为项目 "MyLib" 生成 Javadoc”。

　　IDE 将在“输出”窗口中显示 Javadoc 输出，并打开 Web 浏览器以显示 Javadoc。

　　测试和调试项目

　　现在，我们将使用 JUnit 为项目创建和运行测试，然后在 IDE 的调试器中运行它以检查错误。

　　创建 JUnit 测试

　　1  在“项目”窗口中右键单击 LibClass.java 节点，然后选择“工具”>“JUnit 测试”>“创建测试”(Ctrl-Alt-J)。单击“确定”以使用缺省选项来运行该命令。IDE 将创建 org.me.mylib 包(在“测试包”下)和 LibClassTest.java 文件。

　　2  在源编辑器中选中 LibClass.java 标签的情况下，按 Ctrl-Alt-K 组合键打开测试类。删除 testAcrostic 方法的主体，然后键入或粘贴以下内容:

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

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

　　运行 JUnit 测试

　　1  选择 MyLib 项目节点，然后选择“运行”>“测试 "MyLib"”(Alt-F6)。将在“输出”窗口中打开 MyLib(测试)标签，开始编译和运行 JUnit 测试案例，并传递 LibClassTest.testAcrostic。

　　2  也可以运行单个测试文件，而不是测试整个项目。在源编辑器中选择 LibClass.java 标签，然后从“运行”菜单中选择“运行”>“运行文件”>“测试 "LibClass.java"”。

　　调试项目

　　1  在源编辑器中选择 AcrosticExample.java 标签，在 LibClass 中放置插入记号，然后按 Alt-G 组合键。将在源编辑器中打开 LibClass.java。

　　2  转到 acrostic 方法，并将插入记号放在 b.append(args[i].charAt(i)); 内的任何地方。然后，按 Ctrl-F8 组合键设置一个断点。

　　3  选择“运行”>“调试主项目”(F5)。IDE 将打开“调试器”窗口，并在调试器中运行该项目，直至到达断点处为止。

　　4  选择“局部变量”窗口并展开“参数”节点。字符串数组包含作为命令参数输入的短语。

　　5  在工具栏中单击“继续”(Ctrl-F5)，单步执行程序并观察正在构造的 acrostic。

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

　　定制生成进程

　　在此部分中，我们将使用 IDE 来编辑 Ant 属性和目标。

　　覆盖 Ant 属性

　　1  在“项目”窗口中，右键单击项目节点，然后选择“清除项目”。

　　2  在“文件”窗口中，展开 MyApp 项目节点和 nbproject 文件夹。

　　3  双击 project.properties 以查看 IDE 为项目生成的所有 Ant 属性。

　　4  复制包含 build.dir=build 的行。此属性为编译的类设置输出目录。

　　5  在“文件”窗口中，展开 private 文件夹并双击 private.properties。

　　6  将 build.dir=build 属性粘贴到文件中，并将属性更改为 build.dir=build/production。

　　7  保存文件 (Ctrl-S)。

　　8  选择“生成”>“生成主项目”(F11)。

　　将在 build/production 文件夹中生成编译的类。

　　添加到 Ant 目标中

　　1  在“文件”窗口中，转到 MyApp 项目的 nbproject 文件夹中。

　　2  通过双击 build-impl.xml 在源编辑器中将其打开。此文件包含 IDE 生成的所有 Ant 目标。每个目标都有一个 -pre 目标和一个 -post 目标，可以使用它们来添加 IDE 在运行目标前后要运行的处理指令。不要更改此文件中的目标 — 此文件是由 IDE 自动生成的。

　　3  在“文件”窗口中，转到 MyApp 项目文件夹并双击 build.xml。可以在此文件中覆盖 build-impl.xml 中的目标。

　　4  键入或粘贴以下 Ant 目标，在所有名称以 Remote 开头的类上运行 RMIC:

<target name="-post-compile">    <rmic base="${build.classes.dir}" includes="**/Remote*.class"/></target>