Java教程
Java标识符与关键字
Java变量
Java数据类型
Java运算符
Java控制语句
Java方法
Java面向对象
Java对象的创建和使用
Java封装
Java中static和this
Java继承
Java方法覆盖和多态
Java super
Java基础练习题

Java中的注释

注释是对代码的解释和说明,其目的是让程序员能够更加快速的理解代码。它是编写程序时,写程序的人给一个语句、程序段等的解释或提示,能提高程序代码的可读性。注释在编译的时候不会生成到class字节码文件当中,它只在java源文件中停留。

Java语言的注释包括三种方式,请看以下程序:

/**
 * (javadoc注释,写在这里的注释信息会被JDKbin
 * 目录下的javadoc.exe工具提取并生成帮助文档)
 * 以下程序实现打印九九乘法表功能
 * @author sxbdqn-dujubin
 * @version 1.0
 * @since 1.0
 */
public class NineByNine {
	
	/*
	 	这是程序的入口,也称为主方法(多行注释)
	 	类加载之后,程序从这里进来开始执行
	 */
	public static void main(String[] args) {
		for( int i = 1 ; i <= 9 ; i ++ ){ //外层循环9次,九九乘法表共9行
			for( int j = 1 ; j <= i ; j ++ ){
				System.out.print( j + "*" + i + "=" + i * j + " ");
			}
			System.out.println(); //换行(单行注释)
		}
	}
}

养成编写注释的好习惯,要有编写注释的意识(编写注释是程序员最基本的素质),当然,写注释也是有技巧的,不是所有位置都写,不是把写的代码原版翻译过来,高手往往在写注释的时候,不多不少,能够做到恰到好处,几句话就可以描述清楚程序的核心功能。记住:注释的作用不在于表示代码的含义,而在于表示代码的功能。希望在以后的课程当中通过慢慢的培养,能够写一手漂亮的注释,当然,目前大家只需要掌握注释有哪几种,分别写到什么符号里就行了。

使用注释对HelloWorld程序进行解释说明,这里的描述大家先有个印象就行,后面的课程大家会理解的:

//public关键字表示公开的
//class关键字用来定义类
//HelloWorld是类名
public class HelloWorld {//定义一个公开类,起名HelloWorld
	//大括号要成对儿写
	//这里的大括号括起来的是“类体”
	//这是程序的入口,从这里进来执行
	//static表示静态的
	//void表示main方法执行结束之后不返回任何数据
	//以下行代码除了args可以修改为其它名字之外,剩下的都是固定写法
	//编写代码从现在养成好习惯:合理缩进
//(你包含着我,或者说我比你低一级,就要缩进)
	public static void main(String[] args) {
		//这里的大括号括起来的是“方法体”
		//向控制台输出一句话
		//小括号里面的双引号必须是半角的,不能采用中文
		//这是一条java语句,java语句以“;”结尾,这里的“;”也是半角
		System.out.println("乐学网-口口相传的Java黄埔军校");
	}
	//类体中不能直接编写以下语句
	//System.out.println("乐学网-口口相传的Java黄埔军校");
}