为了方便程序的阅读,Java语言允许程序员在程序中写上一些说明性的文字,用来提高程序的可读性,这些文字性的说明就称为注释。
注释不会出现在字节码文件中,即Java编译器编译时会跳过注释语句。
在Java中根据注释的功能不同,主要分为单行注释、多行注释和文档注释。
单行注释
单行注释使用“//”开头,“//”后面的单行内容均为注释。
多行注释
多行注释以“/*”开头以“*/”结尾,在“/*”和“*/”之间的内容为注释,我们也可以使用多行注释作为行内注释。但是在使用时要注意,多行注释不能嵌套使用。
文档注释
文档注释以“/**”开头以“*/”结尾, 注释中包含一些说明性的文字及一些JavaDoc标签(后期写项目时,可以生成项目的API)
//下面是一段标准代码
//这是代码的“框子”,当前阶段你可以当做一个模板
//其实这就是一个类,类的名字是HelloWorld,这个名字可以随便起,但是一般首字母大写,驼峰命名,见名知意
public class HelloWorld{//下面是一个main方法,方法的格式是固定的public static void main(String[] args){//下面这句话的作用:将双引号中的内容进行原样输出/*这是多行注释每行都可以写单行注释和多行注释,按照你自己的需求去使用即可*/System.out.println("hi....java");}
}
注意:
1.注释不会参与编译,编译后产生的字节码文件中不会有注释的内容
2.注释的作用:
(1)注释就起到了标注解释的作用,提高代码的可读性,方便自己,方便他人--》是一个非常良好,非常专业的习惯!!!
(2)方便代码的调试:
public class HelloWorld2{public static void main(String[] args){ System.out.println("hi....java1");//System.out.println("hi....java2")System.out.println("hi....java3");}
}
/**
文档注释
@author zhaoss
@version 1.0
这是我们第一章文档注释的代码,比较重要
*/
public class HelloWorld3{public static void main(String[] args){ System.out.println("hi....java1"); }/**@param name 姓名@param age 年龄*/public void eat(String name,int age){System.out.println("hello"); }
}
一般文档注释可以配合:jdk提供的工具javadoc.exe来一起使用,通过javadoc.exe可以对文档注释进行解析,生成一套以网页文件形式体现的该程序的说明文档。(自定义类对应的API)



