CKTIS / Java
Параметри varargs в Java: String... и T...
В Java SE 21 параметър varargs приема отделни аргументи или готов масив. При `T...` изтриването на типовете създава риск от замърсяване на хийпа.
Версия: Java SE 21
Синтаксис
static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }В Java SE 21 ... след типа обозначава параметър varargs. Метод или конструктор може да има най-много един такъв параметър и той трябва да е последен. В тялото на метода String... values е от тип String[], а в обобщен метод с типов параметър <T> записът T... values е от тип T[].
При извикване с променлив брой аргументи компилаторът осигурява събирането на последните аргументи в нов масив. labels() получава празен масив, а не null. Ако извикването е възможно без събиране на аргументи, съвместимият масив се подава без копиране и извикващият код вижда промените в елементите му. За показания метод labels(null) и labels((String[]) null) подават нулева референция вместо масив; четенето на length би предизвикало NullPointerException. labels((String) null) подава масив с един елемент null.
При избор на претоварен метод компилаторът първо търси съвпадение без събиране на аргументите: най-напред без boxing и unboxing, после с разрешени преобразувания от двата вида. Само ако и двете фази не намерят приложим метод, се разглежда събирането. Затова метод varargs може да бъде избран във фаза с фиксиран брой аргументи. labels(String...) и labels(String[]) имат еднаква сигнатура и не могат да бъдат отделни претоварени методи.
String е реифицируем тип: типът му е напълно достъпен по време на изпълнение. T не е реифицируем; при събиране на аргументите новият масив използва типа, получен след изтриване на определения за извикването тип на масива. Компилаторът издава предупреждение unchecked при декларацията и може да предупреди и при извикване. Ако същият масив е достъпен чрез референция от тип Object[], запис в него може да наруши гаранциите на обобщените типове. Това замърсяване на хийпа може да се прояви чак при четене като ClassCastException.
@SafeVarargs е уверение от автора, а не проверка по време на изпълнение. Анотацията потиска тези предупреждения при декларацията и на местата на извикване. Допустима е за конструктори varargs и за методи varargs, означени със static, final или private. Използвай я само след проверка, че масивът не се използва и не се предоставя по опасен начин.
Примери
import java.util.Arrays;
import java.util.List;
public class VarargsDemo {
static void labels(String... values) {
System.out.println(Arrays.toString(values));
}
@SafeVarargs
static <T> int count(T... values) {
return values.length;
}
public static void main(String[] args) {
labels();
labels("red", "blue");
labels(new String[]{"green"});
labels((String) null);
labels((String[]) null);
System.out.println(count(List.of("red", "blue"), List.of("green")));
}
}Резултат
[] [red, blue] [green] [null] null 2
`[]` е празен масив, `[null]` е масив с един елемент `null`, а `null` означава, че няма масив. `count` чете само дължината на масива: брои два списъка, а не три низа.
Свързани уроци
- Java · Урок 3 · Напреднало · Версия: 2
- Java · Урок 14 · Напреднало · Версия: 2
Източници
- Java Language Specification, Java SE 21 — §8.4.1 Formal Parameters
- Java Language Specification, Java SE 21 — §8.4.2 Method Signature
- Java Language Specification, Java SE 21 — §15.12.2 Compile-Time Step 2: Determine Method Signature
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §4.7 Reifiable Types
- Java Language Specification, Java SE 21 — §4.12.2 Variables of Reference Type
- Java SE 21 API — SafeVarargs
- Java SE 21 API — Arrays.toString(Object[])
- JDK 21 Tool Specifications — The javac Command