你的位置:首页 > Java教程

[Java教程][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中的关键字。

关键字

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