5.Java学习之注释

注释

1.含义：为了方便程序的阅读，Java语言允许程序员在程序上写上一些说明性的文字，用来提高程序的可读性，这些文字性的说明就称为注释。
2.分类

• 单行注释：使用“//”开头，“//”后面的单行内容均为注释，例如

//这是一行注释，解释说明

• 多行注释：多行注释以“/*”开头以“/”结尾，在这之间的均为注释，多行注释不能嵌套。

/*
这是第一行注释，解释说明
这是第二行注释，解释说明
这是第三行注释，解释说明
/

• 文档注释：以“/**”开头以“*/”结尾，注释中包含一些说明性的文字以及JavaDoc标签（后期写项目时，可以生成项目的API）。一般文档注释可以配合javadoc.exe来一起使用，通过javadoc.exe可以对文档注释进行解析，生成一套以网页文件形式体现的该程序的说明文档。

/**
文档注释
@author wang
@version 1.0
*/
public class HelloWorld{
	public static void main(String[] args){
	   	HelloWorld HW=new HelloWorld();
	   	HW.eat();
		System.out.println("Hi...java!");
	}
	/**
	@param name 名字
	@param age 年龄
	*/
	public void eat(String name,int age){
		System.out.println("hello");
	}
}

执行命令：javadoc -d myHello -author -version HelloWorld.java
在classpath路径下生成myHello文件夹，打开index查看信息。