【java】将自己写的类生成说明文档的方法

使用工具:

jdk中的javadoc

 实现步骤:

1、将java文件放到一个目录之下

2、进入doc(win+R,输入cmd)

3、通过cd指令进入存放java文件的文件夹

4、编译java文件

代码实现:

javac HelloWorld.java

注:

(1)这里如果报如下错的话,使用notepad++将编码格式改成ANSI编码(改编码格式之前先复制好代码)

(2)必须将类设置为public格式,因此类名和文件名必须一样,否则报如下错误

5、调用javadoc

代码实现:

javadoc -d helloWorldDoc HelloWorld.java

注:

(1)该语句是在本文件夹下新建一个helloWorldDoc文件夹来存放说明文档

(2)如果黑框中如图所示,即为生成成功

6、打开doc文档、并打开index.html,如下图,即为说明文档

注:

(1)注意这一句,对比一下源码,正是代码中文档注释的内容,注意文档注释(开头两个*)和块注释(开头一个*)功能大体相同,但是只有文档注释中的内容可以被Javadoc给扫到,所以常常用来给类、方法添加说明。

/**
这是一个生成helloworld的类
*/
public class HelloWorld{
	public static void main(String args[]){
		System.out.println("hello world~");
	}
}

猜你喜欢

转载自blog.csdn.net/tyrant_forever/article/details/107318161