本文内容来自:Java的注释和Javadoc在eclipse生成的方法 – Break易站
1. Java的注释
Java里有两种注释风格。下面这个写法是非常常见的
1
2
3
4
|
/*This is a comment
*that continues
*across lines
*/
|
还可以写成:
1
2
|
/*This is a comment that
continues across lines*/
|
第二种写法如下:
1
|
//This is one-line comment
|
2. Java的嵌入式文档
通常,我们把注释和代码都放到了同一个文件example.java里面,这是为了更好地维护Java文件的注释,因为如果说明文档和源代码分开的话,每次修改源代码之后,还要费力气去维护说明文档API。如果都写在一起,修改的同时,就可以一起维护了。
注释和源代码一起看有时候会比较繁琐,所以,JDK提供了给我们一个提取注释的工具javadoc。这个是能够在Java文件里面提取对应的注释,并且生成HTML文档,以供我们查阅的,非常方便。
那么,我们用eclipse怎么样提取javadoc呢,其实,就在eclipse的project里面就能够自动提取javadoc了。project → Generate javadoc
而javadoc的一些标签,可以使我们在注释文档和生成文档API的时候显得更加的专业,那么,具体的标签有什么呢?请参照下面的表格,查看常用的javadoc:
本文内容来自:Java的注释和Javadoc在eclipse生成的方法 – Break易站
—Author: Arvin Chen —Web Address: www.breakyizhan.com (Break易站)