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官方文档
下面博主介绍两种方式,一种为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文件。
当我们看到这里,生成文档就已经成功了,这时我们打开我们输出的路径,我们可以看到如下文件:
我们选择index.html打开,我们就能看到与JDK文档类似的文档了。
IDEA方法
我们先在IDEA中打开Circle.java文件,然后选择Tools -> Generate JavaDoc…
打开后会出现如下:
我们根据自己的需求填好其中的内容,点击ok即可。然后我们进入我们输出的文件夹中也会看到如下:
我们还是打开index.html文件,发现与上面CMD输出的文档大体一致:
————————————————
版权声明:本文为CSDN博主「一眉程序猿」的原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接及本声明。
原文链接:https://blog.csdn.net/weixin_45935633/article/details/104109299
这篇关于java基础——生成javadom的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!
- 2024-11-01后台管理开发学习:新手入门指南
- 2024-11-01后台管理系统开发学习:新手入门教程
- 2024-11-01后台开发学习:从入门到实践的简单教程
- 2024-11-01后台综合解决方案学习:从入门到初级实战教程
- 2024-11-01接口模块封装学习入门教程
- 2024-11-01请求动作封装学习:新手入门教程
- 2024-11-01登录鉴权入门:新手必读指南
- 2024-11-01动态面包屑入门:轻松掌握导航设计技巧
- 2024-11-01动态权限入门:新手必读指南
- 2024-11-01动态主题处理入门:新手必读指南