ITEM 53: USE VARARGS JUDICIOUSLY
??可變參數(shù)方法的正式名稱是變量特性方法[JLS, 8.4.1]丐箩,它接受指定類型的零個或多個參數(shù)程梦。首先創(chuàng)建一個數(shù)組辩棒,其大小是在調(diào)用站點傳遞的參數(shù)的數(shù)量厨姚,然后將參數(shù)值放入數(shù)組蹋半,最后將數(shù)組傳遞給方法拯啦。
??例如若债,這里有一個可變參數(shù)方法符相,它接受一系列 int 參數(shù)并返回它們的和。如您所料蠢琳,sum(1,2,3)的值為6, sum()的值為0:
// Simple use of varargs
static int sum(int... args) {
int sum = 0;
for (int arg : args)
sum += arg;
return sum;
}
??有時啊终,編寫一個方法需要一個或多個某種類型的參數(shù),而不是零個或多個參數(shù)傲须。例如蓝牲,假設您想要編寫一個函數(shù)來計算其參數(shù)的最小值。如果客戶機沒有傳遞任何參數(shù)泰讽,則此函數(shù)沒有得到很好的定義例衍。你可以在運行時檢查數(shù)組長度:
// The WRONG way to use varargs to pass one or more arguments!
static int min(int... args) {
if (args.length == 0)
throw new IllegalArgumentException("Too few arguments");
int min = args[0];
for (int i = 1; i < args.length; i++)
if (args[i] < min)
min = args[i];
return min;
}
??這個解決方案有幾個問題。最嚴重的情況是已卸,如果客戶端不帶參數(shù)調(diào)用此方法佛玄,則在運行時而不是編譯時失敗。另一個問題是它很丑累澡。必須包含對args的顯式有效性檢查翎嫡,并且不能使用for-each循環(huán),除非初始化 min = Integer.MAX_VALUE永乌,這也很難看惑申。
??幸運的是具伍,有一個更好的方法來達到預期的效果。聲明獲取兩個參數(shù)的方法圈驼,一個是指定類型的普通參數(shù)人芽,另一個是該類型的可變參數(shù)。這個解決方案彌補了前一個的所有不足:
// The right way to use varargs to pass one or more arguments
static int min(int firstArg, int... remainingArgs) {
int min = firstArg;
for (int arg : remainingArgs)
if (arg < min)
min = arg;
return min;
}
從這個例子中可??以看出绩脆,在需要具有可變數(shù)量參數(shù)的方法的情況下萤厅,可變參數(shù)方法是有效的。Varargs 是為與 Varargs 同時添加到平臺上的 printf 和經(jīng)過改造的核心反射設施(item 65)而設計的靴迫。printf 和 reflection 都從 varargs 中受益匪淺惕味。
??在性能關(guān)鍵的情況下使用 varargs 時要小心。每次調(diào)用 varargs 方法都會導致數(shù)組分配和初始化玉锌。如果你已經(jīng)從經(jīng)驗上確定你負擔不起這個成本名挥,但是你需要 varargs 的靈活性,有一種模式可以讓你魚與熊掌兼得主守。假設您已經(jīng)確定95%的方法調(diào)用有三個或更少的參數(shù)禀倔。然后聲明該方法的5次重載,每次重載0到3個普通參數(shù)参淫,當參數(shù)數(shù)量超過3個時使用一個 varargs 方法:
public void foo() { }
public void foo(int a1) { }
public void foo(int a1, int a2) { }
public void foo(int a1, int a2, int a3) { }
public void foo(int a1, int a2, int a3, int... rest) { }
??現(xiàn)在您知道了救湖,在所有參數(shù)數(shù)量超過3的調(diào)用中,您只需要支付5%的數(shù)組創(chuàng)建成本涎才。與大多數(shù)性能優(yōu)化一樣鞋既,這種技術(shù)通常是不合適的,但是當它合適的時候耍铜,它是一個救星涛救。EnumSet 的靜態(tài)工廠使用這種技術(shù)將創(chuàng)建 enum 集的成本降到最低。這是適當?shù)囊蛋牵驗殛P(guān)鍵是 enum 集合為位字段提供具有性能競爭力的替換(item 36)检吆。
??總之,當您需要用可變數(shù)量的參數(shù)定義方法時程储,varargs 是非常有用的蹭沛。在 varargs 參數(shù)之前加上任何必需的參數(shù),并注意使用 varargs 的性能后果章鲤。