Java源文件以.java为扩展名。一个Java应用程序可以有多个Java源文件。Java应用程序的基本结构如下:
- 一个完整的Java程序至少需要一个类(class)。因为Java是完全面向对象的语言,所以所有的代码都是写在类中的。
- Java文件中可以有多个类,但是只能有一个公共类(public),且该公共类的类名与Java文件名相同。
- 在Java中,main()方法是Java应用程序的入口方法,程序在运行的时候,执行的第一个方法就是main()方法,每个独立的应用程序必须要有main()方法才能运行。对main()方法有特定的要求,方法的名字必须是main,且方法必须是public static void类型的,其参数必须是一个字符串数组。
在Windows环境下,使用命令行编译Java程序并输出“Hello”。
创建一个Java项目,命名为ch01,创建一个名为Hello的类
package com.dh.ch01; public class Hello{ public static void main(String[] args){ //输出Hello System.out.println("Hello"); } }
编写完代码后,同时按下“Windows键”和“R键”,打开“运行”窗口,在“运行”窗口中输入“cmd”,单击“确定”按钮,弹出Windows的命令行窗口,然后使用“javac”命令对Hello.java进行编译,最后使用“java”命令对编译好的Hello.class文件进行执行,执行结果如下:
Hello
其代码说明如下:
- 代码的第一行使用package关键字定义了一个包,使用包可以对类进行组织,与其他源代码库中的类分隔开来,确保类名的唯一性。可以不指定类所属的包,此时类将位于默认包中。
- 代码的第二行使用class关键字定义了一个名为Hello的类,因为Hello类修饰符为public,说明此类为公共类,所以文件名必须与类名一直,包括大小写也要一致,即Hello类的源程序文件名必须为Hello.java。
- Hello类的范围由一对大括号"{ }"指定,public是Java的关键字,用来表示该类为公有,也就是在整个程序里都可以访问到它。
- 类主体由许多语句组成,语句一般有两种类型:简单语句和复杂语句。对于简单语句,我们约定一条语句书写一行,语句必须以分好";"来表示结束;而复合语句则是有一对大括号括起来的一组简单语句的集合。
- Hello类中没有定义成员变量,但是有一个成员方法或者main()方法。
- System.out.println("Hello")语句的作用是在程序运行时输出双引号里面的文字内容“Hello”并换行。
注释:用于增加代码的清晰度,尤其是在复杂的程序中,添加注释可以增加程序的可读性,也有利于程序的修改、调试和交流。
单行注释——使用“//”进行标记,用于对某行代码进行注释,可以尾随在某行代码后面,也可以单独成一行。
public static void main(String[] args){ int i = 0; //定义变量i //输出Hello System.out.println("Hello"); }
块注释——使用“/* */”进行标记,通常用于注释多行代码或用于说明文件、方法、数据结构等的意义和用途,一般唯一一个文件或者一个方法的前面,起引导的作用,也可以根据需要放在合适的位置。
/*main 方法负责输出Hello*/ public static void main(String[] args){ //代码省略 }
文档注释——使用“/** */”进行标记,并写入javadoc文档。文档注释用于生成HTML格式的代码报告,所以注释文档必须书写在类、域、构造函数、方法,以及字段(field)定义之前、注释文档由描述和块标记两部分组成。
/** *<h1>main方法负责输出Hello<h1> *@param args *@return */ public static void main(String[] args){ String s = "Hello"; //定义变量s //代码省略 }
使用javadoc命令可以为代码生成类似Java API文档的HTML格式文档,代码中的文档注释会体现在此HTML文档中,便于阅读。文档注释可按照HTML语法进行修饰。如:
<h1>main方法负责输出Hello<h1>
用于在HTML文档中使用一号字体格式显示标签<h1>所修饰的文字
文档注释还可以使用各种内置的标签表达特定的含义。如:
@param args @return
常见javadoc注释标签语法
注释标签 | 说明 |
@author | 对类的说明,标明开发该类模块的作者 |
@version | 对类的说明,标明该类模块的版本 |
@see | 对类、属性、方法的说明 |
@param | 对方法中某参数的说明 |
@return | 对方法返回值的说明 |
@exception | 对方法可能抛出的异常的说明 |