标签：style http io os ar 使用 java sp 文件
一.生成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文件夹将自动生成）
标签：style http io os ar 使用 java sp 文件
原文地址：http://my.oschina.net/u/1415486/blog/339343
