Java中的注释、标识符、关键字

一、 java 注释

Java语言中定义了两种注释形式：

二、 javadoc注释

1、JDK中提供了一个文档自动生成工具javadoc,能够识别Java源文件中符合特定规则的注释语句,根据这些注释语句自动的生成JavaDoc文档 。

用法：javadoc –d despath source.java

例如: javadoc –d ./doc Student.jav

2、在Java源文件中,只有满足特定规则的注视才会构成JavaDaoc文档,这些规范包括：

（1）、注释以”/**”开始,以”*/”结束,里面可以包括普通文本,HTML标记和JavaDoc标记

例如:

 /**
 * Student类,用于演示JavaDoc的使用
 */ public class Student {……}
 

（2）、javadoc只处理源文件在类/接口、方法、变量、 构造器 之前的注释，忽略其他

地方的注释

3. 从javadoc注释中生成API文档的时候，主要从以下几项内容中提取信息：

（1）、包；

（2）、公有（public）类与接口；

（3）、公有（public）方法和受保护（ protected ）方法；

（4）、公有（public）属性和受保护（protected）属性。

三、 javadoc注释—javadoc标记

1、常常在javadoc注释中加入一个以”@”开头的标记，结合javadoc指令的参数，可以在生成的API文档中产生特定的标记

2、常用的javadoc标记

（1）、@author：作者

（2）、@version：版本

（3）、@docroot：表示产生文档的根路径

（4）、@param：方法的参数类型

（5）、@return：方法的返回类型

（6）、@ exception ：抛出的异常

（7）、@ throws ：抛出的异常，和exception同义

四、分割符

1、一条语句是以 分号 （;）结尾的一行代码

2、一个语句块是以一对花括号（{}）为边界的语句的集合

3、Java中允许有任意多的空格 ，包括换行

五、标识符

1、标识符用作给变量、类和方法命名

2、可以以字母、下划线”_”和”$”符开头

3、首字符外，可以跟上字母、下划线”_”和”$”符或数字

4、Java是大小写敏感的，标识符也不例外

5、定义标识符时要注意如下问题

（1）、不能有空格

（2）、不能以数字开头

（3）、不能是java的关键字

（4）、不能有@,#,&等特殊符号

如图所示：

六、Java关键字/保留字

1、Java中一些赋以特定的含义、并用做专门用途的单词称为关键字（keyword）

2、所有Java关键字都是小写的，TURE、FALSE、NULL等都不是Java关键字 ；

3、goto和 const 虽然从未被使用，但也作为Java关键字保留；

Java中一共有51个关键字，如下表所示：