Javadoc是Sun公司提供的一个技术,它从程序源代码中抽取类、方法、成员等注释造成一个和源代码配套的API帮助文档。也就是说,只要在编写程序时以一套特定的标签做注释,在程序编写完成后,经过Javadoc就能够同时形式程序的开发文档了。html
Javadoc输出的是一些静态网页文档,通过WEB浏览器来查看它。
Javadoc的语言规则:
全部Javadoc都只能源于结束。应用javadoc有二种方法:java
一种是嵌入静态网页;浏览器
Javadoc将静态网页源代码嵌入到所生成的静态网页文档中。那样能充分利用静态网页的功能。好比:eclipse
另外一种是应用文档标签编辑器
Sample:工具
Javadoc只能为public或者protected成员中止文档注释。private和包内访问的成员的注释会被忽略掉。那样作是有道理的,因为只有public和protected成员才能在文档以外被应用,这也体现了封装性的优势。编码
1、利用Myeclipse均可轻松制做javadocspa
利用Myeclipse生产javadoc文档的步骤以下:.net
1.选择File->Export->javadoc,下一步。插件
2.Javadoc comand选择JDK的bin目录下的javadoc.exe。选择要生成的源代码和javadoc保存的目的路径,下一步。
3.Document title输入标题,下一步。
4.Extra Javadoc options输入
-windowtitle 'Type B Monitor'[浏览器显示标题]
-bottom <center>Travelsky</center>[底部显示文本],
若是出现编码错误,则填写如下这句
好比项目采用的是UTF-8的编码就填:
-encoding UTF-8 -charset UTF-8
2、利用3个插件均可轻松制做javadoc
JDocEditor,JAutoDoc,Java2Html。三个小工具,轻松制做JavaDoc.一个是可见即所得的JavaDoc编辑工具,一个是自动创建代码注释的工具,一个是把代码转换成Html格式的工具。
JDocEditor:
http://www.certiv.NET/download/downloads.html#jdoceditor
一个所见即所得的Java Doc 编辑器。不用再费神地在代码中调整注释的html标记了,能够自由地编出高质量的带丰富格式的Java Doc 。
JAutoDoc
http://jautodoc.sourceforge.Net/index.html#download
自动创建Java Doc 文档。功能十分强大,三个命令实如今全部源代码中加入完整的Java Doc注释。一个命令是加入Package的说明文档,在Package中加入package.html,对package进行说明。
第二个命令是代码文件的头部注释。一个命令就能够自动地在项目的全部代码文件中加入头部注释,或者替换原来的注释。
第三个命令为类、方法、属性加入注释说明。能够根据模式匹配,自动地根据方法的名称,创建更为具备可读性的注释文本。
Java2Htmlhttp://www.java2html.de/eclipse.html准确地说它不是用来直接创建JavaDoc 的,可是能够用来创建其余文档。它的功能是,把Eclipse中的语法色彩格式转换成为Html,让粘贴到网页上,或者其余文档中的代码带有清晰的语法格式。