使用IDEA生成JavaDoc文档

JavaDoc是Sun公司提供的一种将注释生成HTML文档的技术，生成的HTML文档类似于Java的API。

标记	说明	标签类型
@author 作者	作者标识	包、类、接口
@version 版本号	版本号	包、类、接口
@param 参数名描述	方法的入参名及描述信息，如入参有特别要求，可在此注释。	构造函数、方法
@return 描述	对函数返回值的注释	方法
@deprecated 过期文本	标识随着程序版本的提升，当前API已经过期，仅为了保证兼容性依然存在．以此告之开发者不应再用这个API。	包、类、接口、值域、构造函数、方法
@throws 异常类名	构造函数或方法所会抛出的异常。	构造函数、方法
@exception 异常类名	同@throws	构造函数、方法
@see 引用	查看相关内容，如类，方法，变量等。	包、类、接口、值域、构造函数、方法
@since 描述文本	API在什么程序的什么版本后开发支持。	包、类、接口、值域、构造函数、方法
{@link 包.类#成员标签}	链接到某个特定的成员对应的文档中。	包、类、接口、值域、构造函数、方法
{@value}	当对常量进行注释时，如果想将其值包含在文档中，则通过该标签来引用常量的值。	静态值域

此外还有@serial、@serialField、@serialData、{@docRoot)、{@inheritDoc)、{@lteral})、{@code} {@value arg}几个不常用的

进入正题,使用IDEA生成JavaDoc:
a.IDEA选择Tools->Generate JavaDoc
b.打开Generate JavaDoc窗口:

注释:

序号	解释
1	文档生成范围
2	文档输出路径
3	文档生成语言
4	传入JavaDoc的参数，一般这样写 -encoding UTF-8 -charset UTF-8 -windowtitle “文档HTML页面标签的标题” -link http://docs.Oracle.com/javase/8/docs/api

c.按要求填写好后点击OK,可看到IDEA控制台输出信息:
使用IDEA与命令行生成JavaDoc文档
然后就可在JavaDoc文档输出路径中看到以下文件:
使用浏览器打开index.html文件,可看到如下效果:

当然,除了使用IDEA生成JavaDoc文档,还可以使用更简便的方法:命令行

使用IDEA与命令行生成JavaDoc文档