JAVA-基础-注释

一、注释的概念

　　程序中给人看的提示信息，注释会被编译器忽略，在程序编译和执行的过程中不受任何影响，仅仅在阅读代码时提示信息用。

 

二、注释的形式

　　1.行注释

　　　　基本语法：

　　　　　　　 1 //双斜杠之后到当前行结尾的内容被注释掉了 

　　2.块注释

　　　　基本语法：

　　　　　　

1 /*
2 *    我被注释了
3 *    我也被注释了
4 *    我也一样
5 */    

　　3.文档注释

扫描二维码关注公众号，回复： 6939653 查看本文章

　　　　基本语法：

　　

1 /**
2 *    文档注释通常用来申明一个类、方法、属性的功能
3 *    文档注释在使用时，禁止使用嵌套   
4 *    文档注释在通过javadoc命令生成文档时可以被提取成文档的一部分   
5 */

实验：编写一个类，具有文档注释，通过文档提取工具生成文档

　　1）编写Person.java ，注意，类必须为public，且类名必须和文件名相同

　　　　

 1 /**
 2   这是一个代表人的类
 3 */
 4 public class Person{//声明了一个类，名叫Person
 5   public static void main(String args[]){
 6     /*
 7     床前明月光
 8     疑是地上霜
 9     举头望明月
10     低头思故乡    
11     */
12     System.out.println("hello world~");
13   }
14 }

　　2）通过javadoc命令，提取文档

　　　　

　　3）查看提取出的文档