注释符就是用来标记注释的符号,Java中有3种注释符号
1. 单行注释:
从“//”开始到行末结束,均视为单行注释。
2. 多行注释:
从“/*”开始到“*/”结束,均视为多行注释。
3. 文档注释:
从“/**”开始到“*/”结束,均视为文档注释。
所谓文档注释,是指用javadoc命令可以提取为Java API文档的注释内容,也就是类的注释和方法的注释。
Java中没有标识符的概念,有标识的概念。标识是指包名、类名、方法名、变量名、参数名。在你的代码中,比如类名 slra、方法名 main、参数名 args,这些是标识
1.注释的问题
多行注释。 /* */
多行注释的作用,相对于单行注释而言用多行注释会来的方便...
文档注释。 /** */
文档注释的作用:
javadoc可以直接提取源代码中文档注释,生成对应的【API文档】。
2.标识符
标识符简单来说就是“名字”
例如:类名 是标识符
例如:变量名 是标识符
例如:方法名 是标识符
标识符的规则:有字母、数字、下划线、美元符号四种字符组成,数字不能开头,这样就可以组成一个合法标识符
单行注释:
从“//”开始到行末结束,均视为单行注释。
多行注释:
从“/*”开始到“*/”结束,均视为多行注释。
文档注释:
从“/**”开始到“*/”结束,均视为文档注释。
文档注释与多行注释的区别:
文档注释可以用javadoc命令提取出来,生成类似于jdk文档的网页文件,以便于他人了解一个类的功能。
文档注释的格式:
由于文档注释会被生成为HTML,因此它应符合HTML的语言规范,下面是一个例子:
--------------------------------------------------
/**
* 这是第一行 <br>
***** 这是第二行 <br>
这是第三行
*/
--------------------------------------------------
上面的代码会转换成:
--------------------------------------------------
这是第一行 <br>
这是第二行 <br>
这是第三行
--------------------------------------------------
可以看出,javadoc命令会忽略每一行前面的“*”,而只提取其他的文字。其实如果一行的第一个字符不是“*”,则javadoc命令会将“*”一起提取出来。
文档注释又分为类注释、属性注释和方法注释:
--------------------------------------------------
/** 类注释 */
public class Test {
......
/** 属性注释 */
int number;
......
/** 方法注释 */
public void myMethod() {......}
......
}
--------------------------------------------------
每种注释只能说明其后的类(属性、方法)。
具体可以参考http://www.bitscn.com/java/other/200605/24134.html