JAVADOC及注意的地方.docVIP

JAVADOC格式及注意的地方 对于Java注释我们主要了解两种：　　// 注释一行　　/* ...... */ 注释若干行　　但还有第三种，文档注释：　　/** ...... */ 注释若干行，并写入 javadoc 文档　　通常这种注释的多行写法如下：　　/**　　* .........　　* .........　　*/　　很多人多忽视了这第三种注释，那么这第三种注释有什么用？javadoc 又是什么东西？下面我们就谈谈。　　一. Java 文档和 Javadoc　　Java 程序员都应该知道使用 JDK 开发，最好的帮助信息就来自 SUN 发布的 Java 文档。它分包、分类详细的提供了各方法、属性的帮助信息，具有详细的类树信息、索引信息等，并提供了许多相关类之间的关系，如继承、实现接口、引用等。　　Java 文档全是由一些 html 文件组织起来的，在 SUM 的站点上可以下载它们的压缩包。但是你肯定想不到，这些文档我们可以自己生成。――就此打住，再吊一次胃口。　　安装了 JDK 之后，安装目录下有一个 src.jar 文件或者 src.zip 文件，它们都是以 ZIP 格式压缩的，可以使用 WinZip 解压。解压之后，我们就可以看到分目录放的全是 .java 文件。是了，这些就是 Java 运行类的源码了，非常完