使用eclipse生成java doc文档 【转】
2013-05-10 14:02
741 查看
一、Javadoc介绍
Javadoc其实平常我们都会见到,J***ASE的API文档就是一个javadoc,很明显,Javadoc的目的是为了能够让外部客户理解我们的代码并使用我们对外的接口。记住:编写Javadoc的时候只需要对外的接口即可,不需要内部的接口也编写Javadoc注释;
二、Javadoc注释
一般我们的注释形式是:(1) //
(2) /* */
而Javadoc注释的形式是:
[java] view
plaincopy
/**
*
* @return
*/
注意:必须以/**开头;
三、Eclipse生成Javadoc文档
1.编写Javadoc注释
在Eclipse中,如果在某个方法前面输入/**后回车,则会自动生成Javadoc注释的格式,比如:[java] view
plaincopy
public void setAge(int age) {
this.age = age;
}
在以上代码的上一行输入/** 后回车,则会生成如下形式的注释:
[java] view
plaincopy
/**
*
* @param age
*/
public void setAge(int age) {
this.age = age;
}
2.生成Javadoc注释
如果想生成某个文件或工程的Javadoc文档,则右击后点击Export,然后选择javadoc,即可生成Javadoc;javadoc command:应该选择jdk的bin/javadoc.exe
(可能会出现编码问题,比如一个浏览器不会出现乱码,而一个浏览器会出现乱码,比如我生成的中文文档,safari是乱码,IE不是乱码);
四、示例
代码如下:[java] view
plaincopy
/**
* 创建Person对象的另一种方式
* @param name 姓名
* @param age 年龄
* @return Person对象
*/
public static Person getInstance(String name,int age){
return new Person(name,age);
}
则生成的形式如下:
以下是我实际操作时遇到的问题:
如果出现错误“错误: 编码GBK的不可映射字符”
在vm option里输入 “-encoding utf-8 -charset utf-8”
相关文章推荐
- eclipse 使用 java doc 生成文档的经验
- 使用eclipse生成文档(javadoc)
- Eclipse使用javadoc自动生成文档时 java 非法字符: \65279错误
- 生成javadoc帮助文档 ( 使用eclipse. 命令)
- 【Java】使用Eclipse生成API文档
- 使用 eclipse 生成项目文档
- Eclipse自动生成文件注释以及使用javadoc命令自动生成API文档
- 使用eclipse生成文档(javadoc)
- 使用eclipse生成文档(javadoc)
- eclipse根据C++项目组提供的WEBSERVICE的WSDL文档生成客户端,打成jar包,供spring项目使用
- 使用doxygen生成注释文档——eclipse
- 使用eclipse生成文档(javadoc)主要有三种方法:
- 使用eclipse生成文档(javadoc)
- 使用eclipse生成html格式注释文档 [ javadoc ]
- 开发文档生成工具----Doxygen自动文档生成工具在Eclipse中的集成及使用举例
- 使用eclipse生成html格式注释文档 [ javadoc ]
- Doxygen自动文档生成工具在Eclipse中的集成及使用举例
- 使用eclipse生成文档(javadoc)
- Eclipse设置自动生成文档所使用的@author属性
- Doxygen自动文档生成工具在Eclipse中的集成及使用举例