注释是对代码的解释和说明,其目的是让程序员能够更加快速的理解代码。它是编写程序时,写程序的人给一个语句、程序段等的解释或提示,能提高程序代码的可读性。注释在编译的时候不会生成到class字节码文件当中,它只在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黄埔军校");
}