java怎样生成文档_关于如何生成Java文档

一.生成Java文档，要明白Java注释内容，如果不知道，可以去看上一篇文章。

二.Java系统提供的javadoc工具可以根据程序结构自动生成注释文档。当程序修改时可方便及时更新生成的注释文档。javadoc.exe工具存在于JDK的bin目录下，使用javadoc将读取.java源文件中的文档注释，并按照一定的规则与Java源程序一起进行编译，生成文档。

三.javadoc常用标记：

(上面截图来自javadoc的百度百科，读者也可以自己去百度百科看)，除了这些，还有一些不常用的标记，这里就不列举了。

四.javadoc命令的一般形式：

javadoc [options] [packages] [sourcefiles] [@files]

在命令中有4组可选项，方括号本身不是命令的一部分。命令行的每个选项之间用一个或多个空格分开。各组选项的用途：

①options，指定执行javadoc时的命令选项，如果想显示标准命令选项，可以使用如下命令：javadoc -help

②packages，需要处理的一系列包名，名字之间用一个或多个空格分开

③sourcefiles，一系列用空格分隔的源文件名，可以使用通配符，如果想指定当前目录的所有源文件，可以使用*.java表示

④@files，用空格分隔的一个或多个源文件的名字，也可以是一个或多个包，每个文件必须用@做为前缀符

五.Javadoc中options选项很多，下面列出了常用的选项：

①-author，生成@author标记

②-version，生成@version标记

③-package，把文档输出到包、公有的或受保护的类和成员上

④-public，把文档输出到公有类和成员上

⑤-protected，把文档输出到公有类和受保护的类以及公有的类成员上

⑥-private，把所有类和成员生成文档注释

⑦-d directoryName，使javadoc生成的HTML文件存储在指定的目录下。默认为当前目录

六.示例

Java代码：

注意：

①这个类一定要使用public修饰，这表示对外开放的，这样javadoc才能从中提取出注释文档；

②类中的方法(包括构造)如果使用private修饰，即本类中的内部调用类，则在生成的注释文档中不会显示这个方法，因为private代表它不对外开放。

在命令提示符下操作(先进入源程序目录)：

①javadoc -d myhelp -author -version ArrayTool.java

(这里myhelp是指生成的帮助文档将放在源目录的myhelp子目录下面，这个目录也可以自己设置，只要是完整的路径就可以，如果写了本地磁盘上没有的文件夹，则myhelp文件夹将自动生成)