Java(TM) 支持三种类型的注释,如下表所示:
注释示例
说明
int x; // a comment
一行中"//"后的部分为注释内容
/*The variable x is an integer:*/int x;
"/*" 和 "*/" 之间的所有内容为注释内容,编译器对此注释内容不做处理
/**x -- an integer representing the x coordinate*/int x;
"/**" 和 "*/" 之间的所有内容为注释内容,编译器对此注释内容不做处理,此种注释为文档工具 javadoc 生成文档时所用
文档工具 javadoc 功能非常强大。由 Sun 发行的标准 Java 包括用 javadoc 生成的文档;因此,学习此工具的一个好方法是一边学习包含了注释(这些注释被 javadoc 转换为 HTML 文档)的 Java 源代码,一边参考那些 HTML 文档。