我们知道在Java的注释中,一共有两种格式,第一种是行注释(line comment),第二种是段注释(block comment)。
对于第二种注释,我们还可以进行细分:普通的段注释和文档型的段注释
普通的段注释:
/*
* It is an ordinary block comment
*/
Javadoc段注释:
/**
* It is a Javadoc block comment
*/
其区别在于注释的开头处,前者是 /* 开头,后者是 /**
后者的引用主要是为了生成开发文档(HTML格式)
比如我们看看高德地图API的开发文档:
下面我们来生成自己的API开发文档:
首先创建一个简单的Test类:
/*
* Date: 2012-12-12
*/
package org.javadoc;
/**
* This is a sample Class
*
* @author tsw
* @since 1.0
* @version 1
*/
public class Test {
/**
* <p>This is a sample variable</p>
* <b>It is used for counting</b>
*/
public int counter;
/**
* <p>This is a sample method</p>
*
* @param a left-operand
* @param b right-operand
* @return The sum of a & b
*/
public int calculate(int a, int b) {
return a + b;
}
}
接下来在命令行中敲入:
结果:
进入G:/mytest,查看生成的目录结构:
打开index.html:
如何在Eclipse集成开发环境中生成Javadoc:
点击项目右键->选择Export(输出)->Java->Javadoc
在弹出的对话框中,Javadoc Command 文件路径定位到jdk下的javadoc.exe,比如:C:\Program Files\Java\jdk1.7.0_07\bin\javadoc.exe
Destination选择生成文档的路径。