[Java入门笔记] Java语言基础(一):注释、标识符与关键字

注释

什么是注释?

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

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中的关键字。
public class Test{  //Test是一个标识符
    public static void main(String[] args){  //main args也是一个标识符
    int a = 1;
    int A = 1;  //a和A是两个不同的标识符
    int $i = 2; //标识符正确
    int 123 = 123;  //标识符错误
    int i123 = 123;  //标识符正确
    int i_1 = 1; //正确
    int i.1 = 1;  //错误
    int class = 2;  //class是关键字,错误
  }
}    

 

关键字

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

 

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

Java关键字及其作用

 

posted @ 2015-11-29 20:50  平平平平平  阅读(1919)  评论(0编辑  收藏  举报