注释

什么是注释？

注释是我们在编写代码时某段代码、某个方法、某个类的说明文字，方便大家对于代码的阅读。被注释的内容不会被编译、执行。

Java的注释分为三种类型：单行注释、多行注释、文档注释。

单行注释和多行注释

单行注释在程序中注释一行文字或代码，Java中，使用“//”进行单行注释。多行注释可以一次性将多行代码注释，Java中使用“/*”表示多行注释开头，“*/”表示多行注释结尾

例：

public class CommentTest{
    public static void main(String[] args){
        //这是单行注释
        /*
        多行注释第一行
        第二行
        */
        //System.out.println("被注释的代码不会编译和运行");
        System.out.println("未被注释的代码");
    }
}

Eclipse注释快捷键：Ctrl+/ 单行注释和取消注释；Ctrl+Shift+/ 添加/* */注释 ；Ctrl+Shift+\ 消除/* */注释

文档注释

使用文档注释添加的注释可以通过文档生成工具javadoc生成API文档，javadoc工具只处理文档源文中的以public和protected修饰的类、接口、方法、Field、构造器和内部类前面的注释。

文档注释以“/**”开头，以“*/”结尾。中间的部分是文档注释，会被生成到API文档中。

例：

/**
 * 这是一个文档注释的测试类
 * @author ping
 *
 */
public class Test {

    /** 这是一个Filed */
    public int i;

    /**
     * 这是程序的main方法
     * @param args
     */
    public static void main(String[] args) {

    }
}

关于生成JavaAPI文档，可以参考以下两篇文章：

用javadoc命令生成api帮助文档

eclipse怎样生成javadoc

标识符和关键字

分隔符

Java里的分隔符包括分号（;）、花括号（{}）、方括号（[]）、圆括号（()）、空格、圆点（.），所有的符号都为英文符号，这一点在编写代码的时候要尤为注意。

分号：，Java中，换行不能代表语句结束，只有分号代表一个语句的结束，因此一行中理论上是可以写多个语句，但不推荐这么写，会影响代码的可读性，使代码看起来杂乱。

花括号：一对花括号代表一个语句块，需要成对出现。

方括号：用做数组，定义数组和访问数组元素时使用，也需要成对使用。

圆括号：定义方法时用来包含形参，调用方法和构造方法，需要有圆括号。

空格：用来分割一个语句的多个部分。

圆点：用作使用对象和类的成员使用。

标识符

标识符是用来为程序中的类、方法、变量命名的符号。Java标识符具有以下特点：

• 区分大小写。
• 必须以字符、下划线、美元符号开头，后面可以跟字符、下划线、美元符号和数字四种元素。字符不局限于英文字符，可以是汉字等各国家的文字。
• 不能包含除下划线其他的特殊符号以及空格等。
• 不能是Java中的关键字。

关键字

Java中总共包含48个关键字和两个保留字（goto/const）。

详细介绍可以参考下面这篇文章：

Java关键字及其作用