”参数传递兼文档注释”实战解析,基于ArrayList

package w3ang.javabasic;

import java.util.ArrayList;

public class ValueTest
{
	/** OutPut:
	 * 		Test1:[2, 5]
	 *		Test2:[]
	 *		Test3:[]
	 *@param args main如后参数
	 */
	public static void main(String[] args)
	{
		ArrayList<Integer>testList1=new ArrayList<>();
		Test1(testList1);
		System.out.println("Test1:"+testList1);
		
		ArrayList<Integer>testList2=new ArrayList<>();
		Test2(testList2);
		System.out.println("Test2:"+testList2);
		
		ArrayList<Integer>testList3=new ArrayList<>();
		Test3(testList3);
		System.out.println("Test3:"+testList3);
	}

	static void Test1(ArrayList<Integer>arrayList)
	{
		arrayList.add(2);
		arrayList.add(5);//改变了值testList1
	}
	
	/**
	 * arrayList指向它处了，没有改变testList2，
	 * javadoc默认最低权限选中public。
	 * @param arrayList ArrayList类型参数
	 */
	protected static void Test2(ArrayList<Integer>arrayList)//javadoc默认最低权限选中public
	{
		ArrayList<Integer>tmpList=new ArrayList<>();
		tmpList.add(5);
		tmpList.add(2);
		tmpList.add(3);
		arrayList=tmpList;
	}
	
	/**
	 * arrayList指向它处了，也没有改变testList3，
	 * javadoc默认最低权限选中public，
	 * 文档注释要放在@SuppressWarnings("unchecked")上面。
	 * @param arrayList ArrayList类型参数
	 */
	@SuppressWarnings("unchecked")
	public static void Test3(ArrayList<Integer>arrayList)
	{
		ArrayList<Integer>tmpList=new ArrayList<>();
		tmpList.add(5);
		tmpList.add(2);
		tmpList.add(3);
		arrayList=(ArrayList<Integer>) tmpList.clone();
	}
}