java基础——生成javadom

2021/7/15 22:05:53

本文主要是介绍java基础——生成javadom,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

java基础——生成javadom

使用JavaDoc生成文档,就一定要写出代码的文档注释,关于注释的文章可以查看博主关于Java注释的文章。
下面列举博主觉得常用的一些文档注释标签:

标签 作用
@author 标志编写的作者
@exception 标志抛出的异常
@param 说明一个方法的参数
@return 说明方法的返回值类型
@since 说明该程序的JDK开始版本
@throws 和@exception标签一样
@version 说明版本

我们先看一下JDK的标准文档,JDK8官方文档

img

下面博主介绍两种方式,一种为cmd窗口生成,一种为IDEA生成。

CMD方法

在目录前加入cmd

cmd D:\IdeaWorkspace\javascript\src

javadoc -encoding UTF-8 -charset UTF-8 -d C:\Users\admin\Desktop\Javadoc Circle.java

-encoding UTF-8:表示设置编码。
-charset UTF-8:也表示设置编码。
-d:表示输出目录。
Circle.java:表示我们要生成文档的类的java文件。

当我们看到这里,生成文档就已经成功了,这时我们打开我们输出的路径,我们可以看到如下文件:

img

我们选择index.html打开,我们就能看到与JDK文档类似的文档了。

IDEA方法

img

我们先在IDEA中打开Circle.java文件,然后选择Tools -> Generate JavaDoc…
打开后会出现如下:

img

我们根据自己的需求填好其中的内容,点击ok即可。然后我们进入我们输出的文件夹中也会看到如下:

img

我们还是打开index.html文件,发现与上面CMD输出的文档大体一致:

img

————————————————
版权声明:本文为CSDN博主「一眉程序猿」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/weixin_45935633/article/details/104109299



这篇关于java基础——生成javadom的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!


扫一扫关注最新编程教程