java文档注释（JAVA注解）

一、注释

Java支持三种注释方式

1、单行注释

以双斜杠//标识，只能注释一行内容，//后面的单行内容均为注释。

2、多行注释

包含在“/*”和“*/”之间，能注释很多行的内容。多行注释可以嵌套单行注释，但是不能嵌套多行注释和文档注释。

3、文档注释

包含在“/**”和“*/”之间，也能注释多行内容，一般用在类、方法和变量上面，用来描述其作用。

常用的Javadoc标签

@author 标识一个类的作者 @param 说明一个方法的参数 @return 说明返回值类型 @since 这段函数的创建时间 @throws 可能抛出异常的说明

二、Java标识符

Java语言中，对于变量，常量，函数，语句块的名字，我们统统称之为Java标识符。

标识符是用来给类、对象、方法、变量、接口和自定义数据类型命名的。

命名规则：

1.类和接口名(大驼峰命名法)。

每个字的首字母大写，含有大小写。例如，MyClass，Test，Time等。

2.方法名和变量名(小驼峰命名)。

首字符小写，其余的首字母大写，含大小写。尽量少用下划线。

如：myclass，myName

3.常量名

基本数据类型的常量名使用全部大写字母，字与字之间用下划线分隔。

如：MY_NAME,MY_CLASS

三、Java关键字

Java关键字是Java语言保留供内部使用的，关键字不能用作变量名、方法名、类名、包名和参数。

Java语言共定义了如下所示的关键字：