javase Javadoc注释和生成文档

我们知道 Java 中有三种注释语句:

1.//用于单行注释。

2./*...*/用于多行注释,从/*开始,到*/结束,不能嵌套。

3./**...*/则是为支持 jdk 工具 javadoc.exe 而特有的注释语句。

javadoc 工具能从 java 源文件中读取第三种注释, 并能识别注释

中用@标识的一些特殊变量(见表), 制作成 Html 格式的类说明文档。

javadoc 不但能对一个 java 源文件生成注释文档,而且能对目录和

包生成交叉链接的 html 格式的类说明文档,十分方便。


注释中可以出现的关键字,以@开头:

@author 作者名

@version 版本标识

@parameter 参数名及其意义

@since 最早出现的 JDK 版本

@return 返回值

@throws 异常类及抛出条件

@deprecated 引起不推荐使用的警告

@see 交叉参考



例子:

 /**
*汽车类的简介
*汽车类具体阐述第一行
*汽车类具体阐述第二行
*@author man
*@author man2
*@version 1.0
*@see ship
*@see aircraft

*/
public class Bus{
/**
*用来标识汽车行驶当中最大速度
*@see #averageSpeed
*/
public int maxSpeed;
/**用来标识汽车行驶当中平均速度*/
public int averageSpeed;
/**用来标识汽车行驶当中的水温*/
public int waterTemperature;
/**用来标识天气温度*/
public int Temperature;
Bus(){
}
/**
*该方法用来测量一段时间内的平均速度
*@param start 起始时间
*@param end 截止时间
*@return 返回 int 型变量
*@exception java.lang.exceptionthrowwhenswitchis1
*/
public int measureAverageSpeed(int start,int end ){
int aspeed=12;
return aspeed;
}
/**
*该方法用来测量最大速度
*/
public int measureMaxSpeed(){
     return  1 ; 
}
} 

javadoc 命令:

javadoc -d 文档寄存目录 -author -version 源文件名.java



评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值