1.  Java的注释


Java里有两种注释风格。下面这个写法是非常常见的

/*This is a comment
*that continues
*across lines
*/

还可以写成:

/*This is a comment that
continues across lines*/

第二种写法如下:

//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易站)

 
转载请保留页面地址:https://www.breakyizhan.com/javamind/578.html
扫描二维码添加微信 
  • ,每次淘宝领取淘宝优惠券,淘宝购物更优惠。现在添加微信,还可以领取机械键盘50元优惠券!添加微信后回复机械键盘即可领取!
    支持我们,就用微信淘宝!