/**
 * 這是一個對陣列進行操作的工具類，該類提供了獲取最值、排序等功能。
 * @author CongYao
 * @version V1.1
 */
public class ArrayTool {
	/**
	 * 構造方法私有化 
	 */
	private ArrayTool(){
		
	}
	
	/**
	 * 獲取一個int型陣列中的最大值
	 * @param arr 接收一個int型別的陣列
	 * @return 返回該陣列中的最大值
	 */
	public static int getMax(int[] arr){
		int maxIndex=0;
		for(int i=1;i<arr.length;i++){
			if(arr[i]>arr[maxIndex])
				maxIndex=i;//如果arr[i]>最大值，改變最大值的下標為i
		}
		return arr[maxIndex];
	}
	
	/**
	 * 獲取一個int型陣列中的最小值
	 * @param arr 接收一個int型別的陣列
	 * @return 返回該陣列中的最小值
	 */
	public static int getMin(int[] arr){
		int minIndex=0;
		for(int i=1;i<arr.length;i++){
			if(arr[i]<arr[minIndex])
				minIndex=i;//如果arr[i]<最小值，改變最小值的下標為i
		}
		return arr[minIndex];
	}
		
	/**
	 * 給int型陣列進行氣泡排序
	 * @param arr 接收一個int型別的陣列
	 */
	public static void bubbleSort(int[] arr){
		for(int i=0;i<arr.length-1;i++){
			for(int j=0;j<arr.length-1-i;j++){
				if(arr[j]>arr[j+1])
					swap(arr,j,j+1);
			}
		}
	}
	
	/**
	 * 給int型陣列進行選擇排序
	 * @param arr 接收一個int型別的陣列
	 */
	public static void selectSort(int[] arr){
		for(int i=0;i<arr.length-1;i++){
			for(int j=i+1;j<arr.length;j++){
				if(arr[j]<arr[i])
					swap(arr,i,j);
			}
		}
	}
	
	/**
	 * 將陣列中兩元素進行位置替換
	 * @param arr 接收一個int型別的陣列
	 * @param i 要替換的位置
	 * @param j 要替換的位置
	 */
	private static void swap(int[] arr,int i,int j){
		int temp=arr[i];
		arr[i]=arr[j];
		arr[j]=temp;
	}
	
	/**
	 * 列印陣列中的元素，格式[element1, element2, ...]
	 * @param arr 接收一個int型別的陣列
	 */
	public static void printArray(int[] arr){
		System.out.print("["+arr[0]);
		for(int i=1;i<arr.length;i++)
			System.out.print(", "+arr[i]);
		System.out.println("]");
	}
}
 

public class ArrayToolDemo {

	public static void main(String[] args) {
		int[] arr={23,45,5,34,2,57,432,89};
		syso("maxValue="+ArrayTool.getMax(arr));//列印最大值
		syso("minValue="+ArrayTool.getMin(arr));//列印最小值
		ArrayTool.printArray(arr);//列印陣列元素
		ArrayTool.selectSort(arr);//排序
		ArrayTool.printArray(arr);//列印排序後陣列元素
	}

	public static void syso(String str){
		System.out.println(str);
	}
}
 

將ArrayTool.class檔案傳送給其它人，將該檔案放到classpath路徑下，就可以使用該工具類。
需要通過文件註釋編寫該類的說明書。幫助文件也叫API，Application Program Interface。

寫好文件註釋/** */後，通過javadoc生成API。javadoc -d myhelp -author -version ArrayTool.java
該文件以網頁形式體現，儲存至資料夾中，如果當前目錄沒有該資料夾，建一個，也可以指定目錄c:\myhelp；
如果想體現作者和版本，加-author -version；
如果想把一個類生成幫助文件，類必須用public修飾。

開啟index.html，只有public和protected註釋才會被提取。