Java之利用javadoc生成注释文档

Java里面可以使用javadoc.exe（与javac.exe 和java.exe在同一个目录下）生成代码的注释文档。这是java特有的小工具。

举个小例子：

Demo.java

/**
建立一个用于操作数组的工具类，其中包含着常见的对数组操作的函数如：最值，排序等。
@author 张三
@version v1.0
*/

public class ArrayTool
{
	//该类中的方法都是静态的，所以该类是不需要创建对象的，为了保证不让其他人创建该类对象，可以将构造函数私有化。
    private ArrayTool()
	{
		
	}
	
	/**
	获取整数数组的最大值
	@param arr 接受一个元素为int类型的数组
	@return 该数组的最大元素值。
	*/
	public static int getMax(int[] arr)
	{
		int maxIndex = 0;
		for(int x = 1; x < arr.length; x++)
		{
			if(arr[x]>arr[maxIndex])
			maxIndex = x;
		}
		return arr[maxIndex];
	}
	/**
	对数组进行选择排序
	@param arr 接受一个元素为int类型的数组
	*/
	public static void selectSort(int[] arr)
	{
		for(int x = 0; x<arr.length-1; x++)
		{
			for(int y = x+1; y < arr.length; y++)
			{
				if(arr[x] > arr[y])
					swap(arr, x, y);
			}
		}
	}
	/**
	给数组进行元素的位置置换
	@param arr 接受一个元素为int类型的数组
	@param a  元素的索引
	@param b  元素的索引
	*/
	private static void swap(int[] arr, int a, int b)
	{
		if(arr == null)
			return;
		if(a < 0 || a >= arr.length)
			return;
		if(b < 0 || b >= arr.length)
			return;
		int temp = arrp[a];
		arr[a] = arr[b];
		arr[b] = temp;
	}
}

如何生成javadoc文档？

然后我们执行javadoc命令：javadoc -d myhelp -author -version ArrayTool.java 

简单来说，就是说提取ArrayTool.java代码的注释文档，提取的包含字段为用@author 和@version标示的注释部分，最终保存在myhelp目录下面。

之后，我们可以看到在源代码的同级目录出现了myhelp文件夹，里面包含了注释文档。

打开之后，我们找到index.html文档，打开浏览即可。

注意事项：

1 如果没有myhelp这个目录，会在ArrayTool.java文件所在的目录建立一个myhelp目录。

2 提取的都是公有public的方法，private方法的注释无法提取到文档中。

3 只有 /**  */ 格式的注释可以提取出来，但是 /* */ 和 // 这种格式的提取不出来。