Java注释/JDK开发工具生成API/关键字、标识符规范

注释 1.单行注释// 2.多行注释/* */

/* */

中间是被注释的内容。

在中间回车可以变为文档注释。

3.文档注释/** */

可以作为文档导出注释

/**

在末尾回车即可

javadoc工具导出注释 1.文档注释常用标签

@param：描述方法参数。

@return：描述返回值。

@throws：描述可能抛出的异常。

@see：添加参考链接。

@deprecated：标记方法或类已过时。

2. 使用 javadoc 生成 API 文档 javadoc Student.java

javadoc工具会生成一组 HTML 文件和相关资源文件，这些文件共同构成了完整的 API 文档。

举例：

我们使用文档注释，来输出完整的API文档。

/** * 这是一个表示学生的类。 * 该类包含学生的姓名和年龄信息。 */ public class Student {    private String name;    private int age; ​    /**     * 构造方法，用于创建一个学生对象。     *     * @param name 学生的姓名     * @param age 学生的年龄     */    public Student(String name, int age) {        this.name = name;        this.age = age;   } ​    /**     * 获取学生的姓名。     *     * @return 学生的姓名     */    public String getName() {        return name;   } ​    /**     * 设置学生的姓名。     *     * @param name 学生的姓名     */    public void setName(String name) {        this.name = name;   } ​    /**     * 获取学生的年龄。     *     * @return 学生的年龄     */    public int getAge() {        return age;   } ​    /**     * 设置学生的年龄。     *     * @param age 学生的年龄     */    public void setAge(int age) {        this.age = age;   } ​    /**     * 返回学生的详细信息。     *     * @return 学生的姓名和年龄     */    @Override    public String toString() {        return "Student{name='" + name + "', age=" + age + "}";   } }

3. 生成的文档内容

生成的文档会包含以下信息：

类说明：类的描述、构造方法、方法等。

方法说明：每个方法的参数、返回值、功能描述。

导航栏：方便查看类、方法、字段等。

[重点]为什么注释写了不影响程序运行呢？

源代码——>编译——>字节码文件（其中没有注释的内容）——>虚拟机运行

其实在编译的时候，编译器不会编译注释，生成的字节码文件中没有注释存在，固然就不影响了。

解释举例：

我们看在out文件夹中，打开字节码文件，看不懂。

利用IDEA进行反编译，让字节码文件变为我们能看懂的形式。

这个就是IDEA反编译的字节码文件的结果，我们可以看到不存在注释。

[重点]注释快捷键：

Ctrl + shift + / 多行选中，进行多行注释

Ctrl + / 单行注释

回顾

1.什么是注释？

注释是对程序解释说明的文字。

2.为什么写注释不会影响程序的运行？

字面量

数据在程序中的书写格式。

1.字符

单引号，有且只有一个字符

\n、\t

2.字符串 3.布尔 4.null

双引号，内容没有要求

1.字面量这个知识是告诉同学们什么？

数据在程序中的书写格式。

2.字符、字符串在程序中的书写格式有什么要求？

字符必须单引号围起来，有且仅能一个字符。

字符串必须用双引号围起来。

3.几个常见的特殊值的书写格式是？

true、false、nul、\n、\t

练习：

/** *文档注释 * */ public class Main {    public static void main(String[] args) {        //System.out.println("Hello World");        System.out.println('a');        /*        System.out.println("啦啦啦");        System.out.println(" ");        System.out.println("123\n");        */        System.out.println("-------------");        System.out.println("12\n3");        System.out.println(false);        System.out.println(true);        System.out.println('\n');        System.out.println("\t213");//tab键 ​   } }

一、变量

内存中的一块区域，用来存储一个数据的

int age = 18;

在内存中开辟一块空间age用于存储18。

为什么要使用变量？

用来存储数据，让数据存储更方便。

变量的特点？

变量中的数据是可以被替换，可以赋值

public class Main2 {    public static void main(String[] args) {        int a = 18;        a =a + 1;        System.out.println(a);   } } 回顾

1.变量是什么？变量的完整定义格式是什么？

内存中的一块区域，用来存储一个数据的

数据类型 变量名称 = 数据;

2.变量的特点？

3.应用场景？

记住处理的数据的时候。

---

[重点]注意事项：

1.使用的时候必须先声明，再使用。

2.什么类型的变量，只能存储什么样的类型的数据

[重点]3.变量的有效范围从定义开始到”}“截止，同一个范围内不能定义两个同名变量。

4.变量定义的时候可以没有初始值，但是使用的时候必须进行初始化。

初始化= 定义变量+变量赋值。

public class Main2 {    public static void main(String[] args) {        int a = 12;        System.out.println(a); //       int a = 13;//1.同一个范围内不能定义两个同名变量 //       int d =5.0;//2.什么类型的变量，只能存储什么样的类型的数据       {            int b;            b = 10;            System.out.println(a);//3.[重点]变量的有效范围从定义开始到”}“截止            //[重点]内部代码块可以访问外部的代码块的内容，所以这里是可以打印a变量的。            System.out.println(b);       }      /* int c;        System.out.println(c);//4.变量使用时必须进行初始化，否则报错        */ ​   } }

---

[重点]这里强调一下代码块{}的作用：

规则 1：变量的作用域从定义的位置开始，到其所在的代码块结束（即最近的 }）。

[重点]规则 2：内部代码块可以访问外部代码块的变量，但外部代码块不能访问内部代码块的变量。

规则 3：同一作用域内不能定义同名变量。

[重点]**另一种理解：其实是int a = 12;是在外部的代码块中，虽然输出a语句在内部代码块，但是在int a = 12;属外部的代码块，在外部的代码块之内，随意访问a变量是都可以的。

用代码块的规则2也可以解释。

---

二、关键字，标识符 关键字

关键字（全部是小写）:public 等等

[重点]在IDEA中是高亮显示的都是关键字 特殊：main不是关键字

注意：Java的关键字不能作为：类名、变量名。

标识符

标识符就是名字，我们在写程序时，会起一些名字，如类名、变量名等等都是标识符。

标识符的要求规范

基本组成：数字、字母、下划线_和美元符号$等组成。

强制要求：不能以数字开头、不能用关键字作为名字、且是区分大小写的。

汉字可以作为变量名了，但是不建议用。

[重点]区分 大小写导致的与关键字相似 class 不行,因为是关键字 Class 可以,因为区分大小写,这里不是关键字 _2b 可以 2b 不行，不能以数字开头 $2 可以 [重点]标识符的建议规范

变量名称建议：满足标识符规则，同时用英文、有意义、首字母小写，"驼峰命名"（小驼峰命名）helloWorld

类名称建议：满足标识符规则，同时用英文、有意义、首字母大写，"驼峰命名"。HelloWorld

回顾：

什么是关键字？

java程序要用到词，并且具有特殊含义的词。

不能作为”类、变量名，否做报错

什么是标识符？要满足什么规范？

就是名字

规范：

变量名称建议：

类名称建议：

---

[较重点]变量在计算机底层的存储

进制转换。

十——>二：除二取余法

计算机中的数据的最小单位：字节byte，简称B。

二进制的一位是1个比特bit，简称b。

1字节 = 8bit

1.数据在计算机底层是如何存储的？

2.如何快速算出一个数字的二进制形式？

3.数据在计算机底层存储数据的最小单位是什么？

字节byte 简称B

1字节 = 8比特，简称b

---

文本在计算机如何存储的？

1.字符（文本）在计算机中是如何存储的？

ASCII编码表，美国信息交换标准编码，规定了现代英语、数字字符、和其他西欧字符对应的数字编号。

2.图片

一个像素点 0~255*255*255的颜色值来表示。 就这样表示了

3.音频、

采样：将连续声波离散化为样本点。模拟信号——>离散信号——>计算机

量化：将振幅值转换为数字。

编码：存储为二进制数据（可选择压缩mp3等）。

格式封装：添加元数据，生成音频文件（如 WAV、MP3）。