在介紹 @SafeVarargs 註解用法之前,先來看看如下代碼:
<code>public class HelloWorld { public static void main(String[] args) { // 傳遞可變參數,參數是泛型集合 display(10, 20, 30); // 傳遞可變參數,參數是非泛型集合 display("10", 20, 30); // 會有編譯警告 } public static void display(T... array) { for (T arg : array) { System.out.println(arg.getClass().getName() + ":" + arg); } }}/<code>
代碼第 10 行聲明瞭一種可變參數方法 display,display 方法參數個數可以變化,它可以接受不確定數量的相同類型的參數。可以通過在參數類型名後面加入...的方式來表示這是可變參數。可變參數方法中的參數類型相同,為此聲明參數是需要指定泛型。
但是調用可變參數方法時,應該提供相同類型的參數,代碼第 4 行調用時沒有警告,而代碼第 6 行調用時則會發生警告,這個警告是 unchecked(未檢查不安全代碼),就是因為將非泛型變量賦值給泛型變量所發生的。
可用 @SafeVarargs 註解抑制編譯器警告,修改代碼如下:
<code>public class HelloWorld { public static void main(String[] args) { // 傳遞可變參數,參數是泛型集合 display(10, 20, 30); // 傳遞可變參數,參數是非泛型集合 display("10", 20, 30); // 沒有@SafeVarargs會有編譯警告 } @SafeVarargs public static void display(T... array) { for (T arg : array) { System.out.println(arg.getClass().getName() + ":" + arg); } }}/<code>
上述代碼在可變參數 display 前添加了 @SafeVarargs 註解,當然也可以使用 @SuppressWarnings("unchecked") 註解,但是兩者相比較來說 @SafeVarargs 註解更適合。
注意:@SafeVarargs註解不適用於非 static 或非 final 聲明的方法,對於未聲明為 static 或 final 的方法,如果要抑制 unchecked 警告,可以使用 @SuppressWarnings 註解。