Java关键字标识符注释的使用及规范

梦里梦外; 2022-05-17 03:35 209阅读 0赞

# 1.关键字的概述 #

Java的关键字对java的编译器有特殊的意义，他们用来表示一种数据类型，或者表示程序的结构等，关键字不能用作变量名、方法名、类名、包名。

## 1.1常见的关键字 ##

![这里写图片描述][70]  
![这里写图片描述][70 1]  
备注：不必死记硬背，如果使用关键字作为标识符，编译器能提示错误。  
goto 是java的保留关键字，意思是java并没有使用goto，以后是否使用未定

# 2.标识符 #

## 2.1什么是标识符 ##

就是程序员在定义java程序时，自定义的一些名字，例如helloworld 程序里关键字class 后跟的Demo，就是我们定义的类名。类名就属于标识符的一种。  
标识符除了应用在类名上，还可以用在变量、函数名、包名上。(要求同学们先记住，以后会详细见到这些)

## 2.2标识符必须遵循以下规则 ##

1.标识符由26个英文字符大小写（a~zA~Z）、数字(0~9)、下划线(\_)和美元符号($)组成。  
2.不能以数字开头，不能是关键字  
3.严格区分大小写  
4.标识符的可以为任意长度

## 2.3 标识符案例 ##

### 2.3.1合法的标识符 ###

ComputeArea，radius，area $itcast \_itcast gz\_itcast  
注意：由于Java严格区分大小写，ITCAST 和itcast是完全不同的标识符

### 2.3.2非法标识符 ###

1.class (关键字)  
2.100java(不能以数字开头)  
3.Hello java (空格不是组成标识符的元素)

### 2.3.3Java中的标识符命名规范 ###

**1.包名**  
多个单词组成时所有字母小写（例:package com.itcast）  
**2.类名和接口**  
多个单词组成时所有单词的首字母大写(例：HelloWorld)  
**3.变量名和函数名**  
多个单词组成时第一个单词首字母小写，其他单词首字母大写（例：lastAccessTime、getTime）。  
**4.常量名**  
多个单词组成时，字母全部大写，多个单词之间使用\_分隔（例：INTEGER\_CACHE）  
注意：只是为了增加规范性、可读性而做的一种约定，标识符在定义的时候最 好见名知意，提高代码阅读性。

# 3.注释 #

## 3.1注释的作用 ##

通过注释提高程序的可读性，是java程序的条理更加清晰，易于区分代码行与注释行。另外通常在程序开头加入作者，时间，版本，要实现的功能等内容注释，方便后来的维护以及程序员的交流。

## 3.2注释的种类 ##

1.单行注释（line comment）用//表示，编译器看到//会忽略该行//后的所文本  
2.多行注释(block comment)用/**/表示，编译器看到/*时会搜索接下来的*/,忽略掉/**/之间的文本。  
3.文档注释用/*\** /表示，是java特有的注释，其中注释内容可以被JDK提供的工具 javadoc 所解析，生成一套以网页文件形式体现的该程序的说明文档。

public static void main(String[] args) {
                // 第一步： 获取半径？并将半径保存在程序中
                double radius = 5;
                // 第二步：计算面积，并将面积保存在程序中
                /* double area = radius * radius * 3.1415; // 第三步：在控制台现实面积 System.out.println("半径为" + radius + "的圆的面积为：" + area); */
    
            }

注意：多行注释中可以嵌套单行注释，多行注释不能嵌套多行注释。错误！！！

class Demo{
              /* 这是主函数，是程序的入口 它的出现可以保证程序的独立运行 */
             /* 注意：多行注释嵌套多行注释是不行的。 */
             public static void main(String[] args){
            //这是输出语句用于将括号内的数据打印到控制台。
            System.out.println("hello java");
            }
    }

文档注释 （编写软件说明书）  
1.需要使用sum给我们提供的javadoc工具生成一个html的说明文档。  
2.只能抽取public的属性或者方法内容。  
格式：  
Javadoc –d 指定存储文档的路径 -version –author（可选） 目标文件  
![这里写图片描述][70 2]  
@author 作者  
@version 版本  
@param 方法的参数  
@return 返回值  
注释的使用细节：  
三种注释可以出现在程序的任何地方，但是不推荐找任意位置。  
**编程习惯：**  
1. 给那条语句进行说明，注释应该写在该语句的旁边。  
2. 单行注释一般写在语句的后面多行注释和文档注释一般写在语句的上面  
**注意：文档注释只能出现在类、属性、方法的上面。**  
![这里写图片描述][70 3]  
**注释的嵌套:**  
1.单行注释可以在单行注释里面。  
2.多行注释不能嵌套在多行注释里面。

![这里写图片描述][70 4]  
**注释的调试作用:**  
1. 可以作为初学者的调试方式。  
2. 可以帮组初学者确定代码的错误之处

![这里写图片描述][70 5]

[70]: /images/20220517/a7cc60949dd147e3b92e9128fb882efb.png
[70 1]: /images/20220517/571e0788498b4212b1b5b7d875773159.png
[70 2]: /images/20220517/c913169a10b446b8845dc7255a415455.png
[70 3]: /images/20220517/1f7678d9df514268b691a315753c5716.png
[70 4]: /images/20220517/8817147c239445eea8813a138df4a297.png
[70 5]: /images/20220517/5179ec32d6b64afcb8afb5acbe6b9bf5.png