[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文档,可以参考以下两篇文章:
标识符和关键字
分隔符
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)。
详细介绍可以参考下面这篇文章: