Java 程序设计环境
文档注释
javadoc
JDK中包含的javadoc工具可以由源文件生成一个HTML文档。
javadoc从以下几个特性中抽取信息
- 包
- 公有类与接口
- 公有的和受保护的构造器及方法
- 公有的和受保护的域
包注释:
- 提供一个以package.html命名的HTML文件,body之间的所有文本都会被抽取出来。
- 提供一个以package-info.java命名的文件,包含在/**和*/界定的javadoc注释,跟随在一个包语句之后,它不应该包含更多代码或注释。
生成文档
mac-abeen:java abeen$ ls
alearnJava doc_html javasrc package.html
mac-abeen:java abeen$ javadoc -d doc_html/ alearnJava
正在加载程序包alearnJava的源文件...
正在构造 Javadoc 信息...
标准 Doclet 版本 9.0.4
正在构建所有程序包和类的树...
正在生成doc_html/alearnJava/BaseClassDescription.html...
正在生成doc_html/alearnJava/Employee.html...
正在生成doc_html/alearnJava/HelloSwing.html...
正在生成doc_html/alearnJava/Person.html...
正在生成doc_html/alearnJava/Reflect.html...
正在生成doc_html/alearnJava/Test.html...
正在生成doc_html/alearnJava/Welcome.html...
正在生成doc_html/alearnJava/package-frame.html...
正在生成doc_html/alearnJava/package-summary.html...
正在生成doc_html/alearnJava/package-tree.html...
正在生成doc_html/constant-values.html...
正在构建所有程序包和类的索引...
正在生成doc_html/overview-tree.html...
正在生成doc_html/index-all.html...
正在生成doc_html/deprecated-list.html...
正在构建所有类的索引...
正在生成doc_html/allclasses-frame.html...
正在生成doc_html/allclasses-frame.html...
正在生成doc_html/allclasses-noframe.html...
正在生成doc_html/allclasses-noframe.html...
正在生成doc_html/index.html...
正在生成doc_html/help-doc.html...
mac-abeen:java abeen$