java的三种不同注释方式

注释：是一种在程序源代码中插入的不影响程序运行的文字，可以在不妨碍程序运行的同时，使得代码具有更强的可读性（提前注释好代码的作用总是比看一遍代码理解其作用来的快的），既方便自己回头修改与更新代码，也方便了他人阅读自己的代码。

java中，有三种不同的注释方式：

我们先写最熟悉的"HelloWorld"代码

public class HelloWorld{
	
	public static void main(String [] args){
		System.out.println("HelloWorld");
	}
}

①

//........ 单行注释

 

public class HelloWorld{
	
	public static void main(String [] args){
		System.out.println("HelloWorld");//This is my first java
	}
}

这种注释最大的特点就是操作简单，而其效果也仅仅是只能对单行进行注释

②/*......*/多行注释（注释内容不会写入javadoc生成的文档中）

/*
 *This
 *my
 *first
 *java
 */
public class HelloWorld{
	
	public static void main(String [] args){
		System.out.println("HelloWorld");

	}
}

③/**......./多行注释（注释内容会写入javadoc生成的文档中）

/**
 *This
 *is
 *my
 *first
 *java
 */
public class HelloWorld{
	
	public static void main(String [] args){
		System.out.println("HelloWorld");

	}
}

两种多行注释的对源代码的造成的阅读影响都是一样的  唯一的不同就是会不会被写入javadoc生成的文档

那么这个文档到底是什么？又如何查看呢？

首先: 我们将编译好的源代码保存  之后在运行路径打开cmd 并输入"javadoc -d c:\help -author -version HelloWorld.java" 然后回车运行，像这样

之后打开C盘的help文件夹 打开其中的index.htlm文件，便会弹出网页显示javadoc生成的文档

 

文中没有显示注释  因为我使用的是第二种方式，如果换作第三种注释方式，便会是以下结果