有些时候我们会把常用的函数封装成类,编译成.class文件,给别人使用,但别人不知道这个类有哪些方法该如何如何调用,此时我们需要做一个类的说明文档:采用在.java类里面进行注释,通过注释来生成类的说明文档的方法。
一、注释的写法:
注释用/**开始,*/作为结尾。
@author 作者
@version 版本
@param arr 传入的值 (arr是方法参数的名称,“传入的值”是对参数名的说明)
@return 返回的值 (返回什么这里填写什么,“返回的值”是对返回值的说明)
trans.java:
/**
* 此类用于给数组排序,求最值
* @author aaa
* @version 1.0
*/
public class trans {
public trans()
{
}
/**
* 给int数组进行选择排序
* @param a 传入一个数组
*/
public static void ssort(int []a)
{
for(int i=0;i<a.length-1;i++)//控制循环次数
{
for(int j=i+1;j<a.length;j++)
{
if(a[i]>a[j])
{
int t=a[i];
a[i]=a[j];
a[j]=t;
}
}
}
}
/**
* 求一个int数组的最大值
* @param arr 传入一个int数组
* @return 返回一个int数值
*/
public static int max(int[] arr){
int j=arr[0];
for(int i=0;i<arr.length;i++){
if(j<arr[i]){
j = arr[i];
}
}
return j;
}
/**
* 求一个int数组的最小值
* @param arr 传入一个int数组
* @return 返回一个int数值
*/
public static int min(int[] arr){
int j = arr[0];
for(int i=0;i<arr.length;i++){
if(j>arr[i]){
j = arr[i];
}
}
return j;
}
public static void main(String [] args)
{
System.out.print("ok");
}
}
注意:此类要用public 否则无法生成说明文档
二、在dos中采用如下命令生成说明文档:
javadoc -d helpdoc -author -version trans.java
1、-d:指明生成后文件的目录
2、helpdoc:生成后的文件的目录,若当前目录下没有此该文件名则会自动生成该目录用于存放生成的文件。
3、-author:生成作者
4、-version :生成版本号
三、生成后的说明文档:
生成后,保存的文件是网页文件.html的,双击index.html即可用浏览器打开查看。
在这个说明文档中,有构造函数的说明,如果我们需要取消,只需要把构造函数定义为私有的。