《Chp2 Java语言基础》.pdf

Chp2 Java 语言基础 本章导读 在上一章里，我们介绍了 Java 语言的一些背景，并介绍了Java 语言环境的配置，为后 面进一步的学习打下良好的基础。 从本章开始，我们将逐步开始介绍Java 语言的语言特性和语法规则。 1 注释 注释指的是一些描述代码的文字。 我们可以把对代码的各方面描述，都写成代码的注释。注释中典型的内容包括：这段代 码是如何工作的、这段代码使用了什么算法、这段代码执行的流程如何，等等。 注释不是 Java 代码的一部分，编译时，编译器会把Java 代码翻译成字节码，而注释则 会被编译器自动忽略。因此，代码中有没有注释，都不会影响到代码运行的结果。 但是，注释却是编程中必不可少的内容。有良好注释的代码，能够极大的增强代码的可 读性。也就是说，加上注释的代码更容易让人读懂。 对于初学者而言，一开始可能并不会意识到注释的意义。然而我们要知道，Java 代码是 给机器看的，同时也是给人看的，事实上，程序员看代码的时间远远超过Java 编译器看代 码的时间（想象一下你调试和写程序需要多久，而编译器编译程序需要多久）。因此，我们 写程序应当注重“可读性”，也就是说，我们写出的代码应当尽可能让人容易读懂。随着工 作量和代码量的增加，越来越多的代码和越来越复杂的逻辑会让程序员很难读懂、修改和维 护代码。也许有一天，在看到自己写的代码的时候，你也会发出这样的感叹: “咦，这段代 码真的是我写的么？我怎么一点都看不懂了？”（当然，发出这样的感叹说明你确实积累了 不少代码了）。这时候，注释能给程序员带来最大的帮助。 Java 中的注释从语法上来说主要有三种：单行注释、多行注释和javadoc 注释。 1.1 单行和多行注释 单行注释和多行注释，是很多编程语言中常见的注释语法。 在Java 中，单行注释以“// ”开头，直到遇到一个换行符为止。以下为合法的单行注释： Eg 1： //This is a comment. Eg 2： System.out.println(“ABC”); // This is another comment Eg 3： if (XXX) { //This is comment }else { //This is else } 1 多行注释以“/* ”开头，以“*/”结尾，在/*和*/之间的所有内容，均作为注释。 以下为多行注释的例子： Eg 1 /* This is Comment */ 多行注释可以跨行，例如： Eg 2 /* This is a example Of multi-line comment */ 特别要注意的是，多行注释不能嵌套。例如以下程序片段： /* This is comment /*can not have inside comment*/ */ 这个程序片段在多行注释中包含了另一个多行注释，会引发一个编译错误。 1.2 javadoc 注释 javadoc 注释，是Java 中一种比较特殊的注释。这种注释用来生成api 文档。 程序员在对外发布 Java 代码的时候，还应当对外公布这些代码的用法。这样，才能让 其他的程序员能够更加方便的利用已有的代码。在Java 中，我们往往使用api 文档，来向其 他程序员介绍代码的组成和用法。 例如，Sun 公司发布的JDK，包括了一个庞大的类库，为了说明这些类的用法，Sun 公 司还提供了相应的api 文档。 Java1.6 的文档链接如下： /javase/6/docs/api/ 下图显示了java.lang.Object 类的api 文档： 对于程序员来说，如何来生成这样的api 文档呢？很显然，让程序员直接手工编写，是 一件非常麻烦的事情。为此，Java 提供了一种相对比较简单的机制。