程序员scholar
  • Java
  • JavaSE - 基础篇
scholar
2024-01-17
目录

Java基础语法

# 前言

Java以前自学过一写，现在工作了，时间太久有一些知识都遗忘了，今天开始就更新Java了，想着把之前的Java基础知识捡起来；从最基础的开始，打好Java基础，便于以后复习。也欢迎大家跟我一起复习。

# 1. 注释（annotation）（掌握）

在Java编程语言中，注释是用来解释和说明代码的文字，旨在帮助人们更容易地理解代码的功能和目的。注释不会影响程序的编译和执行，它们仅作为代码的附加说明存在。Java中主要有三种类型的注释：

  1. 单行注释：以两个斜线//开头，直到行末结束。用于简短的说明或注释掉单行代码。

    // 这是一个单行注释
    1

  2. 多行注释：以/*开头，以*/结束。可以跨越多行，用于提供较长的说明，或临时注释掉一段代码块。

    /*
 这是一个多行注释
 可以跨越多行
 */
    1
    2
    3
    4

  3. 文档注释：以/**开头，以*/结束。这是Java特有的注释形式，用于生成JavaDoc文档。文档注释可以包含一些特定的注释标签（如@param、@return等），这些标签会在生成的文档中以特定的格式显示。

    /**
 * 文档注释演示
 *
 * @author gaoziman
 * @param args main方法的命令参数
 * @return 无返回值
 */
public class Comments {
    public static void main(String[] args) {
        System.out.println("hello");
    }
}
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12

# 文档注释的常见标签：

  • @author：指明代码的作者。
  • @version：标明代码的版本。
  • @see：提供参考信息，如其他类、方法或文档。
  • @since：标明从哪个版本开始添加的。
  • @param：描述方法的参数。
  • @return：描述方法的返回值。
  • @throws或@exception：描述方法可能抛出的异常。

文档注释是编写Java API文档的重要工具，通过使用javadoc命令，可以根据源代码中的文档注释自动生成HTML格式的API文档，这对于维护大型项目和提供库的用户文档非常有用。

# javadoc工具生成API文档

要使用javadoc命令生成Java文档注释，你需要遵循以下步骤。这个命令工具是Java开发工具包（JDK）的一部分，用于从Java源代码中提取文档注释并生成HTML格式的API文档。

# 1. 准备好Java源文件

确保你的Java源文件中包含了合适的文档注释。文档注释是以/**开头，以*/结束的注释，用于提供关于类、方法、变量等的描述信息。文档注释可以包含多个注释标签，如@param、@return、@throws等。

# 2. 打开命令行或终端

打开你的操作系统的命令行（Windows上的命令提示符或PowerShell，MacOS或Linux上的终端）。

# 3. 定位到源文件目录

使用cd命令切换到包含你的Java源文件的目录。

cd path/to/your/java/files
1

# 4. 运行javadoc命令

在命令行中输入javadoc命令，后跟一系列选项和你想要生成文档的Java源文件名。最基本的用法是：

javadoc YourClass.java
1

这将会为YourClass.java生成文档。

如果你想要为多个Java文件生成文档，可以一次性指定多个文件：

javadoc YourClass1.java YourClass2.java
1

或者，如果你想要为当前目录下的所有Java文件生成文档，可以使用*通配符：

javadoc *.java
1

# 5. 指定输出目录

默认情况下，javadoc会在当前目录下创建一个名为doc的文件夹，并将生成的HTML文件存放在其中。你可以使用-d选项指定一个不同的输出目录：

javadoc -d /path/to/output/directory YourClass.java
1

# 6. 使用其他选项

javadoc命令支持许多其他选项，以控制生成的文档的外观和内容。例如，-author和-version选项会在文档中包含作者和版本信息：

javadoc -author -version YourClass.java
1

更多选项和详细信息可以在官方文档中找到，或通过运行javadoc -help查看。

# 7. 查看生成的文档

javadoc命令执行完成后，你可以在指定的输出目录中找到生成的HTML文件。用任何网页浏览器打开index.html文件，就可以查看生成的API文档了。

通过遵循上述步骤，你可以轻松地使用javadoc命令为Java项目生成详细的API文档。这对于文档化你的代码库和提高代码的可读性和可维护性非常有帮助。

# 2. 标识符( identifier)（掌握）

简单的说，凡是程序员自己命名的部分都可以称为标识符。

即给类、变量、方法、包等命名的字符序列，称为标识符。

# Java中合法的标识符规则：

  1. 组成：标识符可以包含字母（A-Z，a-z，包括全球所有语言的字符）、数字（0-9）、下划线（_）和美元符号（$）。这意味着除了数字、字母、下划线和美元符号外的任何字符都不能作为标识符的一部分。
  2. 开头：标识符不能以数字开头。
  3. 关键字限制：标识符不能使用Java中的关键字，如class、public、static等。
  4. 区分大小写：Java中的标识符是区分大小写的，因此foo和Foo被视为不同的标识符。
  5. 长度限制：理论上，标识符的长度没有限制，但出于代码的可读性和可维护性考虑，应当选择合理长度的名称。

# 命名规范（建议遵守）：

标识符的命名规范（建议遵守的软性规则，否则容易被鄙视和淘汰）

  • 见名知意：选择有意义的名称，能够反映出变量的用途、方法的行为或类的特性。
  • 类名和接口名：使用驼峰式命名法，每个单词的首字母大写，例如StringBuffer、ArrayList。
  • 变量和方法名：首单词以小写字母开始，从第二个单词开始每个单词的首字母大写，例如firstName、calculateTotalWidth。
  • 包名：所有字母均使用小写，单词之间通过点（.）分隔，例如java.util、org.springframework。
  • 常量名：所有字母均使用大写，单词之间使用下划线（_）分隔，例如MAX_PRIORITY、MIN_VALUE。

以下是合法的标识符：

  1. name
  2. _name
  3. $name
  4. name123
  5. Name
  6. MyClassName

以下是不合法的标识符：

  1. 123name（以数字开头）
  2. public（关键字）
  3. my-name（中间包含横线）
  4. MyClassName!（包含非法字符）

# 3. 关键字（keyword）（掌握）

关键字：是指在程序中，Java已经定义好的单词，具有特殊含义。

Java关键字是Java编程语言中预先定义的一组保留字，具有特定的语义。这些关键字在Java程序中扮演着控制程序结构和流程的角色，它们被Java语言赋予了特殊的意义和用途，因此不能被用作标识符，如变量名、方法名或类名等。

# 关键字的作用和种类

Java关键字的作用范围广泛，涵盖了：

  • 定义数据类型（如int、boolean、char等）
  • 流程控制（如if、for、while、switch等）
  • 访问控制（如public、private、protected）
  • 类、方法和变量修饰符（如static、final、abstract、synchronized）
  • 错误处理（如try、catch、finally、throw、throws）
  • 包的声明和引用（如package、import）
  • 实例化和继承（如new、extends、implements）
  • 创建实例及引用（如this、super）
  • 并发编程（如volatile、transient）

# 关键字的特点

  • 所有的关键字小写。
  • Java关键字数量为50个，其中const和goto是保留字，目前未被使用，但保留以备将来可能的使用。
  • 特殊值true、false和null虽然常被认为是关键字，但严格来说，它们是Java语言的字面量（Literals），代表布尔值和空引用。

# 使用关键字的注意事项

  • 关键字不能作为标识符使用。
  • 在编写Java程序时，需要避免将关键字用于除其预定用途之外的地方，以防编译错误。
  • 学习和使用关键字时，不必强行记忆所有关键字，重要的是理解每个关键字的用途和应用场景。

1555209180504

# 4. 字面量（理解）

在Java中，字面量（Literal）是指在源代码中直接给出的值。它们代表自身的值，不需要任何计算就可以直接被程序使用。字面量是构成程序中数据的基础，用于初始化变量，或者直接参与表达式的计算。

# 字面量的种类

Java中的字面量主要包括以下几种类型：

  1. 整数型（Integer Literals）：直接表示整数值的字面量，可以是十进制（如100）、十六进制（如0xFF）、八进制（以0开头，如077）、二进制（以0b或0B开头，如0b1010）。

  2. 浮点型（Floating-point Literals）：表示小数点的值，如3.14、-0.5等。浮点型字面量默认为double类型，若要指定为float类型，需在字面量后添加f或F后缀（如3.14f）。

  3. 布尔型（Boolean Literals）：表示逻辑上的真或假，只有两个布尔型字面量：true和false。

  4. 字符型（Character Literals）：表示单个字符的值，使用单引号'括起来，如'a'、'1'、'\n'（表示换行符）等。

  5. 字符串型（String Literals）：表示字符串的值，使用双引号"括起来的字符序列，如"Hello"、"Java"等。

  6. 空字面量（Null Literal）：null关键字用来表示对象引用的字面量，它不指向任何对象。

# 字面量的使用

字面量可以直接用在代码中，例如初始化变量、作为方法参数、或参与运算表达式。例如：

int age = 30; // 整数型字面量
double temperature = 36.6; // 浮点型字面量
boolean isAdult = true; // 布尔型字面量
char grade = 'A'; // 字符型字面量
String greeting = "Hello, World!"; // 字符串型字面量
1
2
3
4
5

通过使用字面量，开发者可以在编写Java程序时直接嵌入固定的值，使代码更简洁易读。字面量是Java语言中表达常量值的一种非常直接和高效的方式。

以上便是本文的全部内容，本人才疏学浅，文章有什么错误的地方，欢迎大佬们批评指正！我是scholar，一个在互联网行业的小白，立志成为更好的自己。

如果你想了解更多关于scholar (opens new window) (opens new window)，可以关注公众号-书生带你学编程，后面文章会首先同步至公众号。

公众号封面

编辑此页 (opens new window)
上次更新: 2024/12/28, 18:32:08
Java环境搭建
Java数据类型

← Java数据类型→

Theme by Vdoing | Copyright © 2019-2025 程序员scholar