一、注释的概念
程序中给人看的提示信息,注释会被编译器忽略,在程序编译和执行的过程中不受任何影响,仅仅在阅读代码时提示信息用。
二、注释的形式
1.行注释
基本语法:
1 //双斜杠之后到当前行结尾的内容被注释掉了
2.块注释
基本语法:
1 /*
2 * 我被注释了
3 * 我也被注释了
4 * 我也一样
5 */
3.文档注释
基本语法:
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)查看提取出的文档