码迷,mamicode.com
首页 > 编程语言 > 详细

生成JavaDoc文档

时间:2020-02-14 00:29:47      阅读:119      评论:0      收藏:0      [点我收藏+]

标签:idea   param   ram   png   ret   介绍   version   版本号   head   

JavaDoc是一种将注释生成HTML文档的技术,生成的HTML文档类似于Java的API,易读且清晰明了。在简略介绍JavaDoc写法之后,再看一下在Intellij Idea 中如何将代码中的注释生成HTML文档。

java中的注释有三种:

  1. 单行注释:在IDEA中快捷键为Ctrl+/

  2. 多行注释:在IDEA中快捷键为Ctrl+Shift+/

  3. 文档注释:

    @author 作者名

    @version 版本号

    @since 指明需要最早使用的jdk版本

    @param 参数名

    @return 返回值情况

    @throws 异常抛出情况

生成javadoc文档两种方式

javadoc命令

javadoc命令是用来生成自己API文档的

1.打开IDEA,右键要生成文档的类hello,打开其所在文件夹位置。

技术图片

2.在该文件夹里打开命令窗口。

技术图片

3.输入命令 javadoc -encoding utf-8 -charset utf-8 hello.java,也就是javadoc + 参数 +java类 。

技术图片

4.完成。

技术图片

 

直接在IDEA中生成javadoc

1.IDEA菜单栏的tools,选中Generate JavaDoc。

技术图片

2.点击OK完成。

技术图片

 

最后生成的API文档

 

生成JavaDoc文档

标签:idea   param   ram   png   ret   介绍   version   版本号   head   

原文地址:https://www.cnblogs.com/xiaoran991/p/12305876.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!