学习笔记------JAVA注释

@JAVA学习笔记----JAVA的三种注释

单行注释，多行注释，文档注释

1.java规范的三种注释方式：
单行注释 //
多行注释 /**/
文档注释(java特有)

2.单行注释和多行注释的作用
(1)对所写的程序进行解释说明，增强可读性。
(2)调试所写的代码。

3.特点：
单行注释和多行注释，注释的内容不参与编译，也就是说编译以后生成的.class结尾的字节码文件中不包含注释掉的信息。

4.文档注释的使用
文档注释的注释内容可以被JDK提供的工具javadoc 所解析，生成一套以网页文件形式体现的该程序的说明文档。
操作方法：
命令：javadoc -d mydoc -author -version HelloWorld.java
其中 mydoc 是自己取的名字

5.多行注释不可以嵌套使用

例子说明

public class HelloWorld{
	/*
	对第一个java程序进行总结
	1.Java程序编写-编译-运行
	编写：我们将编写的java代码保存在以“.java”结尾的源文件中
	编译：使用javac.exe命令编译我们的java源文件。格式：javac 源文件名.java
	运行：使用java.exe命令解释运行我们的字节码文件。格式：java 类名
	
	2.在一个java源文件中可以声明多个class。但是，只能最多有一个类声明为public的。
	而且要求声明为public的类，类名必须与源文件名相同。
	
	3.程序入口是main()方法。格式是固定的。
	
	4.输出语句：
	System.out.println();先输出再换行
	System.out.print();只输出
	
	5.每一行执行语句都以“;”结束
	
	6.编译以后，会生成一个或多个字节码文件。字节码文件的文件名与java源文件中的类名相同。
	
	*/
	/*
	多行注释：
	如下main方法是程序的入口。
	*/
	/**
	文档注释：
	如下的方法是main()，作用：程序的入口。
	*/
	public static void main(String[] args){
		//单行注释：如下语句表示输出到控制台
		System.out.println("Hello World！！！！!");
	}
}

执行命令后会生成一个文件，如下图所示：


打开index.html，就能看到生成的说明文档啦！

说明文档中是不包含单行注释和多行注释的！！！！