[JAVA] JAVA 文档注释

Java 程序设计环境

文档注释

javadoc

JDK中包含的javadoc工具能够由源文件生成一个HTML文档。

javadoc从如下几个特性中抽取信息

• 包
• 公有类与接口
• 公有的和受保护的构造器及方法
• 公有的和受保护的域

包注释：

1. 提供一个以package.html命名的HTML文件，body之间的全部文本都会被抽取出来。
2. 提供一个以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$