Java 入门程序&注释

简单的Java程序

Java的开发步骤

1. 将 Java 代码编写到扩展名为 .java 的文件中。
2. 通过 javac 命令对该 java 文件进行编译。
3. 通过 java 命令对生成的 class 文件进行运行。

HelloWorld

public class FirstSample {
   
   
    public static void main(String[] args) {
   
   
        System.out.println("Hello, World!"); 
    }
}

• Java 区分大小写。 如果出现了大小写拼写错误（例如，将 main 拼写成 Main)，程序将无法运行。
• 关键字 public 称为访问修饰符（access modifier)。用于控制程序的其他部分对这段代码的访问级别。一个源文件中最多只能有一个public类。其它类的个数不限，如果源文件包含 一个public类，则文件名必须按该类名命名。
• class 表明 Java 程序中的全部内容都包含在类中。这里只需要将类作为一个加载程序逻辑的容器，程序逻辑定义了应用程序的行为。
• class 后面紧跟类名。名字必须以字母开头，后面可以跟字母和数字的任意组合。长度基本没有限制，不能使用 Java 保留字。

标准的命名规范：类名是以大写字母开头的名词。如果名字由多个单词组成，每个单词的第一个字母都应该大写（在一个单词中间使用大写字母的方式称为骆驼命名法)。

• 源代码的文件名必须与公共类的名字相同，并用 .java 作为扩展名。因此，存储这段源代码的文件名必须为 FirstSample.java。
• 在编译这段源代码之后就会得到一个包含这个类字节码的文件。Java 编译器将字节码文件自动地命名为 FirstSample. class, 并与源文件存储在同一个目录下。
• 运行已编译的程序时，Java 虚拟机将从指定类中的 main 方法开始执行（这里的“方法”就是 Java 中所说的“函数”），在类的源文件中必须包含一个 main方法。也可以将自定义的方法添加到类中，并且在 main 方法中调用它们。
• 用大括号划分程序的各个部分（通常称为块)。Java 中任何方法的代码都用“ { ” 开始，用“ } ”结束。
• 每个 Java 应用程序都必须有一个 main 方法，其声明格式如下所示：

public class ClassName {
   
   
    public static void main(String[] args) {
   
   
        // 程序语句
    }
}

每个句子必须用分号结束。回车不是语句的结束标志，所以可以将一条语句写在多行上。

System.out 对象调用了它的 println 方法。点号（.）用于调用方法。

Java 使用的通用语法是：object.method (parameters)

注释

用于注解说明解释程序的文字就是注释。提高了代码的阅读性；调试程序的重要方法。注释是一个程序员必须要具有的良好编程习惯。

对于单行和多行注释，被注释的文字，不会被JVM（java虚拟机）解释执行。

单行注释

其注释内容从 // 开始至本行结尾

// 注释文字

多行注释

当需要长篇注释时，既可以在每行的注释前面标记 // ，也可以使用 /*和*/将一段比较长的注释括起来。在Java中，/* */注释不能嵌套。

/*
这是一段多行的注释 
这是本段中的第二行注释 
*/

文档注释 (Java特有)

注释内容可以被JDK提供的工具 javadoc 所解析，生成一套以网页文件形式体现的该程序的说明文档。

/**
    其他注释信息
    @author 指定java程序的作者
    @version 指定源文件的版本
    其他注释信息
    ...
*/

操作方式：

javadoc -d mydoc -author -version 文件名.java

Java API文档

API （Application Programming Interface,应用程序编程接口）是 Java 提供的基本编程接口。

Java语言提供了大量的基础类，因此 Oracle 也为这些基础类提供了相应的API文档，用于告诉开发者如何使用这些类，以及这些类里包含的方法。

https://www.oracle.com/java/technologies/javase-jdk8-doc-downloads.html