2.2　第一个Java程序

打开NetBeans开发环境，在菜单栏中选择“文件”→“新建项目”选项，打开项目创建窗口。然后，选择“Java”→“Java应用程序”，并单击“下一步”按钮继续，如图2-8所示。

图2-8　创建Java项目

接下来需要填写一些项目信息，如图2-9所示。

本例中，项目名称填写为FirstDemo，项目位置、项目文件夹和其他选项都使用默认设置即可。单击“完成”按钮完成项目的创建工作。然后，可以看到NetBeans的主界面，如图2-10所示。

图2-9　新建项目信息

图2-10　NetBeans的主界面

现在，从简单的信息输出开始，在代码编辑区中，修改代码内容（FirstDemo.java文件），如下所示。

实际上，只需要输入其中加粗的这一行代码，其功能就是显示一行信息。单击工具栏中的“执行”按钮，可以看到如图2-11所示的输出结果。

代码的功能虽然很简单，但它也算是一个完整的Java应用。接下来，单击工具栏中的“项目构建”按钮，就可以生成Java应用的两种主要发布文件类型，分别是FirstDemo.class和FirstDemo.jar文件，前者是编译后的Java字节文件，后者是打包后的发布文件，可以将其复制到已安装JDK的环境中使用。

本例中，生成的FirstDemo.jar文件默认位于“文档”中的NetBeansProjects\FirstDemo\dist目录中，把它复制到C:盘根目录下。接下来，通过cmd打开命令行窗口，并切换到C:盘根目录。然后，使用java命令来执行FirstDemo.jar文件，如图2-12所示。

图2-11　信息输出结果

图2-12　运行JAR文件

其中，cd/命令用于返回根目录。然后，在java命令中使用-jar参数，指定要执行的是.jar文件，-jar参数后指定的就是刚刚复制过来的FirstDemo.jar文件。

请注意，如果找不到java命令，可以根据上一节内容设置JDK相关的环境变量。

2.2.1　语句与语句块

在NetBeans环境中，可以看到FirstDemo.java文件中的代码有各种颜色和符号，而真正执行的代码却很少，如下面的代码所示。

实际上，显示一条信息的功能，只需要这些代码就可以了，而其他内容都是注释（稍后讨论）。接下来，了解这些代码的功能。

首先是package语句，它指定当前文件的代码定义在哪个包（package）中，这里的包名就是firstdemo。请注意，package语句的最后以分号（;）结束，这也是一个简单的Java语句。

此外，包是Java代码的基本组织形式。除了使用package语句定义包之外，还可以使用import语句引用其他包中的资源，在后面的学习中可以看到相关应用。

接下来，使用public和class关键字定义一个FirstDemo类。在这里，使用“{”和“}”定义类的主体部分，称之为代码块。

类中可能会包含很多成员。而本例的FirstDemo类中只包含一个main()方法，它是应用执行的入口，也就是说，Java程序的执行是从这里开始的。可以看到，main()方法的主体部分同样定义在“{”和“}”符号之间。

System.out.println()方法的功能就是输出一些内容，在NetBeans环境和执行.jar文件时，已经看到输出结果。

2.2.2　注释内容

Java代码中，灰色的内容定义为注释，也就是一些说明性的内容，它们不是真正的执行代码。

Java中，可以使用三种注释。第一种称为行注释，以//开头，一直到行结束的内容都会被当作注释。行注释可以在单独的行中，也可以在其他代码的后面，如：

    // 显示信息
    System.out.println("第一行Java代码");              // 显示信息

第二种注释称为块注释，其内容包含在/*和*/之间，如：

    /*
     * FirstDemo.java
     *Author: caohuayu
     * Version: 20170606
    */

此外，在块注释中可以使用一些以@符号标识的指令，在FirstDemo.java文件中可以看到一些，如：

    /**
     * @param args the command line arguments
    */代码中使用@param指令说明args参数

对于这些使用特殊指令的注释，可以通过javadoc命令创建HTML文档。下面将FirstDemo.java文件复制到C:盘根目录下。然后，使用cmd打开命令行窗口，并使用javadoc命令自动创建文档，如图2-13所示。

图2-13　使用javadoc命令生成文档

本例中使用的命令行如下：

    javadoc FirstDemo.java -D c:\firstdemo

其功能是创建FirstDemo.java代码文件的HTML文档，文档会存放在C:\firstdemo目录中。操作完成后，打开C:\firstdemo目录，可以看到index.html文件，图2-14中就是通过Firefox浏览器查看的结果。

图2-14　javadoc命令生成的HTML文档

NetBeans环境中，在菜单栏中选择“运行”→“生成Javadoc”选项来创建HTML文档，然后会通过浏览器打开。此外，通过NetBeans环境生成的文档默认放在项目文件夹的/dist/javadoc/目录中。

上一章目录下一章