JavaDoc注释的使用跟导出JavaDoc文档

原创 2012年03月29日 14:27:59
1.Javadoc是什么:
 JavaDoc是Sun公司提供一种从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档技术,但是需要在编写程序时以一套特定的标签作注释,在程序编写完成
后,通过Javadoc就可以同时形成程序的开发文档了。Javadoc输出的是一些HTML文件,我们可以通过WEB浏览器来查看它。
2.Javadoc的语法:
所有Javadoc都只能源于/**开始和*/结束的注释,使用Javadoc有两种方式,一种是嵌入HTML,另一种是使用文档标签,所谓文档标签就是一些以"@"开头的命令,且"@"要置于注释行的最前面
,而“行内文档标签”则可以出现在Javadoc注释中的任何地方,它们也是以“@”字符开头,当要包括在共括号内。
Javadoc只能为public或者Protected成员惊醒文档注释,private和包内访问的成员注释会被忽略掉,因为只有public和protected成员才能在文件之外被使用,只要也体现了封装的有点。
嵌入HTML:
javadoc将HTML代码嵌入到所生成的HTML文件中,这样能充分利用HTML的功能,比如:
/**
*<b>
*this is my test application.
*</b>
*/
但一般我们不要在HTML里是同标题,如<h1><hr>,因为Javadoc会插入自己的标题,我们的标题可能会干扰它。
一些常见的标签:
1)@see:引用其他类的文档,相当于超链接,Javadoc会再其生成的HTML文件中,将@see变迁连接到其他的文档。
@see classname这样在生成的文档中会出现“See Also”的超链,但是Javadoc不去检查你的超链接是否有效。
2){@link package.class#memeber label}与@see的功能一样,只是用label作主超链接,而不是用“see also”。
3)@docRoot:标签产生到文档根目录的相对路径,用于文档树页面的显式超链接。
4)@inheritDoc:标签从当前这个类的最直接基类中继承相关问道到当前的文档注释中。
5)@version:使用方法@version 2.2.1.1...是我们做的版本信息说明。
6)@author:使用方法为@author后加上作者名字,email等联系方式。
7)@since:这个标签允许你指定程序最早使用的版本。比如我们看JDK Document里的每个类最后都会说明从JDK哪额版本开始启用。
8)@param:@param name 用户输入客户的姓名。@param后面是方法的参数,以及相应的说明,我们可以使用任意数量的此标签,每个参数都可以有这样一个标签。
9)@return 后面是描述返回值的含义,可以延续几行。
10)@throws fully-qualified-class-name description 为异常类的完整名字,而description告诉你为什么此异常会再方法调用中出现。
11)@deprecated:用于指出一些旧特性已由改进的新特性所取代,建议用户不要在使用旧特性。
使用eclipse工具生成Javadoc文档:
方法1.在项目列表中选中项目右键,选择Export(导出),然后在Export(导出)的对话框中选择java下的javadoc,转到下一步,在Javadoc Generation对话框中有两个地方要注意:
javadoc command:应该选择JDK安装目录下bin/javadoc.exe.
destination:生成文档的保存路径,自由选择保存路径。按finish即可来时生成文档。
方法2:在Eclipse菜单选择:File》Export(文件》导出),后续步骤跟方法1一致。
方法3:选中要生成文档的项目,然后用菜单选择,Project》Generate Javadoc直接进入Javadoc Generation对话框,后续步骤也跟方法1一致。
注:如果项目采用的UTF-8的编码,一定要在Extra Javadoc options选项中添加”-encoding UTF-8 -charset UTF-8",否则生成的网页中文注释都是乱码。 

1.Javadoc是什么:
 JavaDoc是Sun公司提供一种从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档技术,但是需要在编写程序时以一套特定的标签作注释,在程序编写完成
后,通过Javadoc就可以同时形成程序的开发文档了。Javadoc输出的是一些HTML文件,我们可以通过WEB浏览器来查看它。
2.Javadoc的语法:
所有Javadoc都只能源于/**开始和*/结束的注释,使用Javadoc有两种方式,一种是嵌入HTML,另一种是使用文档标签,所谓文档标签就是一些以"@"开头的命令,且"@"要置于注释行的最前面
,而“行内文档标签”则可以出现在Javadoc注释中的任何地方,它们也是以“@”字符开头,当要包括在共括号内。
Javadoc只能为public或者Protected成员惊醒文档注释,private和包内访问的成员注释会被忽略掉,因为只有public和protected成员才能在文件之外被使用,只要也体现了封装的有点。
嵌入HTML:
javadoc将HTML代码嵌入到所生成的HTML文件中,这样能充分利用HTML的功能,比如:
/**
*<b>
*this is my test application.
*</b>
*/
但一般我们不要在HTML里是同标题,如<h1><hr>,因为Javadoc会插入自己的标题,我们的标题可能会干扰它。
一些常见的标签:
1)@see:引用其他类的文档,相当于超链接,Javadoc会再其生成的HTML文件中,将@see变迁连接到其他的文档。
@see classname这样在生成的文档中会出现“See Also”的超链,但是Javadoc不去检查你的超链接是否有效。
2){@link package.class#memeber label}与@see的功能一样,只是用label作主超链接,而不是用“see also”。
3)@docRoot:标签产生到文档根目录的相对路径,用于文档树页面的显式超链接。
4)@inheritDoc:标签从当前这个类的最直接基类中继承相关问道到当前的文档注释中。
5)@version:使用方法@version 2.2.1.1...是我们做的版本信息说明。
6)@author:使用方法为@author后加上作者名字,email等联系方式。
7)@since:这个标签允许你指定程序最早使用的版本。比如我们看JDK Document里的每个类最后都会说明从JDK哪额版本开始启用。
8)@param:@param name 用户输入客户的姓名。@param后面是方法的参数,以及相应的说明,我们可以使用任意数量的此标签,每个参数都可以有这样一个标签。
9)@return 后面是描述返回值的含义,可以延续几行。
10)@throws fully-qualified-class-name description 为异常类的完整名字,而description告诉你为什么此异常会再方法调用中出现。
11)@deprecated:用于指出一些旧特性已由改进的新特性所取代,建议用户不要在使用旧特性。
使用eclipse工具生成Javadoc文档:
方法1.在项目列表中选中项目右键,选择Export(导出),然后在Export(导出)的对话框中选择java下的javadoc,转到下一步,在Javadoc Generation对话框中有两个地方要注意:
javadoc command:应该选择JDK安装目录下bin/javadoc.exe.
destination:生成文档的保存路径,自由选择保存路径。按finish即可来时生成文档。
方法2:在Eclipse菜单选择:File》Export(文件》导出),后续步骤跟方法1一致。
方法3:选中要生成文档的项目,然后用菜单选择,Project》Generate Javadoc直接进入Javadoc Generation对话框,后续步骤也跟方法1一致。
注:如果项目采用的UTF-8的编码,一定要在Extra Javadoc options选项中添加”-encoding UTF-8 -charset UTF-8",否则生成的网页中文注释都是乱码。


1.Javadoc是什么:
 JavaDoc是Sun公司提供一种从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档技术,但是需要在编写程序时以一套特定的标签作注释,在程序编写完成

后,通过Javadoc就可以同时形成程序的开发文档了。Javadoc输出的是一些HTML文件,我们可以通过WEB浏览器来查看它。
2.Javadoc的语法:
所有Javadoc都只能源于/**开始和*/结束的注释,使用Javadoc有两种方式,一种是嵌入HTML,另一种是使用文档标签,所谓文档标签就是一些以"@"开头的命令,且"@"要置于注释行的最前面

,而“行内文档标签”则可以出现在Javadoc注释中的任何地方,它们也是以“@”字符开头,当要包括在共括号内。
Javadoc只能为public或者Protected成员惊醒文档注释,private和包内访问的成员注释会被忽略掉,因为只有public和protected成员才能在文件之外被使用,只要也体现了封装的有点。
嵌入HTML:
javadoc将HTML代码嵌入到所生成的HTML文件中,这样能充分利用HTML的功能,比如:
/**
*<b>
*this is my test application.
*</b>
*/
但一般我们不要在HTML里是同标题,如<h1><hr>,因为Javadoc会插入自己的标题,我们的标题可能会干扰它。
一些常见的标签:
1)@see:引用其他类的文档,相当于超链接,Javadoc会再其生成的HTML文件中,将@see变迁连接到其他的文档。
@see classname这样在生成的文档中会出现“See Also”的超链,但是Javadoc不去检查你的超链接是否有效。
2){@link package.class#memeber label}与@see的功能一样,只是用label作主超链接,而不是用“see also”。
3)@docRoot:标签产生到文档根目录的相对路径,用于文档树页面的显式超链接。
4)@inheritDoc:标签从当前这个类的最直接基类中继承相关问道到当前的文档注释中。
5)@version:使用方法@version 2.2.1.1...是我们做的版本信息说明。
6)@author:使用方法为@author后加上作者名字,email等联系方式。
7)@since:这个标签允许你指定程序最早使用的版本。比如我们看JDK Document里的每个类最后都会说明从JDK哪额版本开始启用。
8)@param:@param name 用户输入客户的姓名。@param后面是方法的参数,以及相应的说明,我们可以使用任意数量的此标签,每个参数都可以有这样一个标签。
9)@return 后面是描述返回值的含义,可以延续几行。
10)@throws fully-qualified-class-name description 为异常类的完整名字,而description告诉你为什么此异常会再方法调用中出现。
11)@deprecated:用于指出一些旧特性已由改进的新特性所取代,建议用户不要在使用旧特性。

使用eclipse工具生成Javadoc文档:
方法1.在项目列表中选中项目右键,选择Export(导出),然后在Export(导出)的对话框中选择java下的javadoc,转到下一步,在Javadoc Generation对话框中有两个地方要注意:
javadoc command:应该选择JDK安装目录下bin/javadoc.exe.
destination:生成文档的保存路径,自由选择保存路径。按finish即可来时生成文档。
方法2:在Eclipse菜单选择:File》Export(文件》导出),后续步骤跟方法1一致。
方法3:选中要生成文档的项目,然后用菜单选择,Project》Generate Javadoc直接进入Javadoc Generation对话框,后续步骤也跟方法1一致。

注:如果项目采用的UTF-8的编码,一定要在Extra Javadoc options选项中添加”-encoding UTF-8 -charset UTF-8",否则生成的网页中文注释都是乱码。


 

[Java]简易使用JavaDoc生成说明文档

相信大家都已经看过了不少说明文档,例如Java API、Android API,它们无疑都是这样的:...
  • u011596810
  • u011596810
  • 2016年03月08日 14:48
  • 8269

Java中文档生成JavaDoc使用注意

java文档注释javadoc使用
  • adayabetter
  • adayabetter
  • 2015年04月08日 11:30
  • 1694

JavaDoc生成API详解

一、综述 1.简介   Javadoc是Java自带的一种工具,其可以从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。也就是说,只要在编写程序时以一套特定的标签作注...
  • fanxiaobin577328725
  • fanxiaobin577328725
  • 2016年09月25日 11:02
  • 6440

MyEclipse生成javadoc文档

详细看图,下面贴出大体步骤 一。右键项目,选择Export 二。选择java下面的javadoc 三。create javadoc for members with visibility解释 四。选好...
  • kakarot5
  • kakarot5
  • 2014年11月01日 19:56
  • 1380

javadoc生成注释文档

一、javadoc
  • u011459278
  • u011459278
  • 2014年05月13日 23:01
  • 2447

使用javadoc工具生成API文档

API文档的创建其实很简单, 当我们在eclipse工具上创建好一个工程并为每个类添加了文档注释后,用接下来的步骤即可完成api的生成: 右击工程-----》选择导出export-----》选择ja...
  • u012440258
  • u012440258
  • 2017年02月26日 10:10
  • 283

生成Javadoc文档

  • 2010年08月14日 15:10
  • 11KB
  • 下载

JAVA 文档注释--JAVADOC文档

 项目到了尾声,大家都开始头疼——又要写文档了……是的,我们大多数人都不是从正规的Programer训练出来的。当初学习编程序的时候,就从来没有想过要给自己写的那几个程序编写一份完整的文档,所有的注释...
  • gxf212
  • gxf212
  • 2006年11月20日 15:58
  • 7821

Javadoc注释规范

Javadoc虽然是Sun公司为Java文档自动生成设计的,可以从程序源代码中抽取类、方法、成员等注释形成一个和源代码配套的API帮助文档。(Javadoc is a documentation ge...
  • GarfieldEr007
  • GarfieldEr007
  • 2017年02月09日 23:30
  • 1282

使用eclipse生成javadoc文件

1.1、生成javadoc。在Eclipse的Project菜单上,点Generate javadoc。一路next下去,注意在最后需要指定生成的编码(-encoding UTF-8 -charset...
  • whb19891011
  • whb19891011
  • 2017年07月14日 18:25
  • 91
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:JavaDoc注释的使用跟导出JavaDoc文档
举报原因:
原因补充:

(最多只允许输入30个字)