Java规范的三种注释方式
1.单行注释
格式://这后面写注释
2.多行注释(多行注释不可以嵌套使用)
格式:/*这里是多行注释的内容*/
3.单行注释和多行注释的作用:
- 对所写的程序进行解释说明,增强可读性。方便自己,方便别人
- 调试所写的代码
4.单行注释和多行注释的特点:
单行注释和多行注释,注释了的内容不参与编译。
换句话说,编译以后生成的.class结尾的字节码文件中不包含注释掉的信息
5.文档注释(Java当中特有的注释方式)
格式:
/**
文档注释
@author shkstart
@version v1.0
这是我的第一个java程序!
*/
使用:
注释内容可以被JDK提供的工具javadoc
所解析,生成一套以网页文件形式体现的该程序的说明文档。
注释方法示例:
/** 文档注释 @author thiswei @version v2.0 这是我的第一个java程序! */ public class HelloThiswei{ /* 这里使用了一个多行注释 可以含括多行内容 */ public static void main(String[] args){ //这里是一个单行注释,下面用于输出语句 System.out.println("这是我的第一个程序文件"); } }
然后打开cmd,使用javadoc
对这个文件进行编译
(这里命令是javadoc -d 文件名 -author -version Java文件名
)
之后在文件夹当中会出现这样的问文件夹名叫myHello
点开index.html文件后,就可以看到一些有关内容,发现其中只会有文档注释当中的内容并没有其他注释当中的内容。