IntelliJ IDEA与eclipse生成JavaDoc的方法

JavaDoc是一种将注释生成HTML文档的技术。

1、使用javadoc命令生成文档

• 首先了解一下javadoc指令的用法

用法: javadoc [options] [packagenames] [sourcefiles] [@files]

使用指令生成文档，这里的java文件的编码是utf-8，所以要带上编码选项 -encoding utf-8
指令 javadoc -encoding utf-8 Fish.java

打开index.html文件

使用eclipse生成文档

• 选中java文件，右键选择Export，进入Export界面，选Java-Javadoc

点击Next，选中目录

两次一直选择Next，配置VM options指定源文件编码为 -encoding utf-8 ， 点击Finsh

查看生成文档过程的信息与文档

3、 Intellij Idea生成JavaDoc

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

先看一段样例代码：

稍微解释一下：

以//: 开始，以///:~结束。

@author  作者名

@version 版本号

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

@param 参数名

@return 返回值情况

@throws 异常抛出情况

idea生成HTML文档的方法：

第一步：

第二步：

1. 选择是整个项目还是模块还是单个文件

2. 文档输出路径

3. Locale 选择地区，这个决定了文档的语言，中文就是zh_CN

4. 传入JavaDoc的参数，一般这样写 -encoding UTF-8 -charset UTF-8 -windowtitle "文档HTML页面标签的标题" -link http://docs.Oracle.com/javase/7/docs/api