CKTIS / Java
@SafeVarargs — деклариране на безопасна обработка на varargs
`@SafeVarargs` е гаранцията на автора, че даден метод или конструктор обработва безопасно своя параметър varargs. Тя потиска определени unchecked предупреждения при декларацията и местата на извикване, но не проверява и не поправя безопасността на типовете.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs е анотация от java.lang. Параметърът varargs се обработва като масив. Когато типът на елементите му не е реифицируем, например List<String>, по време на изпълнение не е налична пълната информация за типа. Така възниква риск от замърсяване на heap: стойностите може да не съответстват на декларираните генерични типове.
@SafeVarargs потиска unchecked предупреждението за такава декларация и за създаването на параметризирани масиви при местата на извикване. За разлика от @SuppressWarnings("unchecked") върху декларация на метод, тя влияе и върху извикванията на този метод. Не потиска всички предупреждения в тялото на метода.
В Java SE 21 тя може да се използва при конструктори varargs и методи varargs, означени с static, final или private. Използването ѝ при декларация без varargs или при метод, който не отговаря на тези условия, е грешка при компилация. При реифицируеми типове на елементите, като String, тя е излишна и компилаторът може да издаде предупреждение.
Това е обещание на автора, а не доказателство за безопасност. Небезопасен запис чрез псевдоним на масива все още може да причини ClassCastException. В примера totalSize само чете масива groups, без да записва в него или да го предоставя, което обосновава обещанието.
Примери
import java.util.List;
public class Main {
@SafeVarargs
static int totalSize(List<String>... groups) {
int total = 0;
for (List<String> group : groups) {
total += group.size();
}
return total;
}
public static void main(String[] args) {
System.out.println(totalSize(List.of("A", "B"), List.of("C")));
}
}Резултат
3
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.