2.1 注释
2.1.1单行注释和多行注释
-
单行注释:在程序中注释一行代码。
用法:将双斜线(//)放在需要注释的内容之前。
例如://需要注释的内容
-
多行注释:一次性地将程序中的多行代码注释掉。
用法:使用”/*”和“*/”将程序中需要注释的内容包含起来。
例如: /* 需要注释的内容
需要注释的内容 */
2.1.2文档注释
文档注释:介绍该文档使用的类、方法、成员变量等,用于生成API文档;
注释文档由两部分组成描述、块标记。
用法:①以(/**)开始,(*/)结束,中间部分是文档注释的内容
②在doc中将文档注释生成API文档方法:
doc命令:javadoc -d 目录 文件名.java
Ps:javadoc工具默认不会提取@author和@version两个标记的信息,如果需要提取这两个标记的信息,应该在使用javadoc工具时指定-author和-version两个选项。
如:javadoc -d 目录 -version -author 文件名.java
如:/**@author 作者
*@param 输入参数的名称 说明
*@return 输出参数说明
*@since JDK版本
*@version 版本号
*@see 链接目标
*@throws 异常
*@deprecated 解释
*@link 链接地址
*/
2.2 标识符与关键字
2.2.1 分隔符
分号(;):每个Java语句必须使用分号作为结尾。
花括号({}):一个代码块。
方括号([]):用于访问数组元素
圆括号(()): 方法调用、方法参数、运算符优先级
空格( ):缩进可读性、不同语句部分
圆点(.):通常用做类/对象和它的成员之前的分隔符。
2.2.2 标识符规则
①标识符可以由字母、数字、下画线(_)和美元符($)组成,其中数字不能打头。
②标识符不能是Java关键字和保留字(goto等),但可以包含关键字和保留字,
③标识符不能包含空格
④标识符只能包含美元符、不能包含@、#等其它特殊字符。
标识符作用:可用作 常量、变量、方法、类、接口等的命名。
2.2.3 关键字
①Java一共包括48个关键字:
abstract、assert、boolean、break、byte、case、catch、char、class、continue、 default、do、double、else、enum、extends、final、finally、float、for、if、implements、 import、int、interface、instanceof、Long、native、new、package、private、protected、 public、return、short、static、strictfp、super、switch、synchronized、this、throw、 throws、transient、try、void、volatile、while
②Java还提供了3个特殊直接量:true、false、null