Java生成javadoc


一、Javadoc介绍


Javadoc其实平常我们都会见到,JAVASE的API文档就是一个javadoc,很明显,Javadoc的目的是为了能够让外部客户理解我们的代码并使用我们对外的接口。

记住:编写Javadoc的时候只需要对外的接口即可,不需要内部的接口也编写Javadoc注释;


二、Javadoc注释


一般我们的注释形式是:

(1) //

(2) /* */

而Javadoc注释的形式是:

/** * * @return */

注意:必须以/**开头;


三、Eclipse生成Javadoc文档


1.编写Javadoc注释
在Eclipse中,如果在某个方法前面输入/**后回车,则会自动生成Javadoc注释的格式,比如:

public void setAge(int age) { this.age = age; }在以上代码的上一行输入/** 后回车,则会生成如下形式的注释:

/** * * @param age */ public void setAge(int age) { this.age = age; }

2.生成Javadoc注释

如果想生成某个文件或工程的Javadoc文档,则右击后点击Export,然后选择javadoc,即可生成Javadoc;

(可能会出现编码问题,比如一个浏览器不会出现乱码,而一个浏览器会出现乱码,比如我生成的中文文档,safari是乱码,IE不是乱码);


四、示例


代码如下:

/** * 创建Person对象的另一种方式 * @param name 姓名 * @param age 年龄 * @return Person对象 */ public static Person getInstance(String name,int age){ return new Person(name,age); }

则生成的形式如下:





  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值