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文档。
先看一段样例代码:
1 //: object/Documentation
2 /** 这是一个Javadoc测试程序
3 * @author Mike
4 * @version 1.0
5 * @since 1.5
6 * */
7 public class Documentation {
8 /**这是一个成员变量
9 * */
10 public String name;
11 /** a function
12 * @param name 姓名
13 * @return 返回name姓名
14 * @throws Exception 无异常抛出
15 * */
16 public String function(String name) throws Exception{
17 return name;
18 }
19 }///:~
稍微解释一下:
以//: 开始,以///:~结束。
@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