Java的注释和Javadoc在eclipse生成的方法 – Break易站

本文内容来自: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生成的方法

本文内容来自:Java的注释和Javadoc在eclipse生成的方法 – Break易站


—Author: Arvin Chen —Web Address: www.breakyizhan.com (Break易站)

posted on 2017-12-20 20:32  MrAit  阅读(246)  评论(0编辑  收藏  举报

导航