Javadoc其实平常我们都会见到,JAVASE的API文档就是一个javadoc,很明显,Javadoc的目的是为了能够让外部客户理解我们的代码并使用我们对外的接口。
记住:编写Javadoc的时候只需要对外的接口即可,不需要内部的接口也编写Javadoc注释;
一般我们的注释形式是:
(1) //
(2) /* */
而Javadoc注释的形式是:
注意:必须以/**开头;
如果想生成某个文件或工程的Javadoc文档,则右击后点击Export,然后选择javadoc,即可生成Javadoc;
(可能会出现编码问题,比如一个浏览器不会出现乱码,而一个浏览器会出现乱码,比如我生成的中文文档,safari是乱码,IE不是乱码);
则生成的形式如下:
