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生成的方法 – Break易站

---

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