CKTIS / Java
@SafeVarargs — deklariranje sigurnog rukovanja varargsom
`@SafeVarargs` je autorovo jamstvo da metoda ili konstruktor sigurno obrađuje svoj parametar varargs. Potiskuje određena upozorenja unchecked u deklaraciji i na mjestima poziva, ali ne provjerava niti popravlja sigurnost tipova.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs je anotacija iz java.lang. Parametar varargs obrađuje se kao polje. Kada njegov tip elemenata nije reificirljiv, primjerice List<String>, tijekom izvođenja nisu dostupne potpune informacije o tipu. Zbog toga postoji rizik onečišćenja hrpe: vrijednosti možda ne odgovaraju deklariranim generičkim tipovima.
@SafeVarargs potiskuje upozorenje unchecked koje se odnosi na takvu deklaraciju i stvaranje parametriziranih polja na mjestima poziva. Za razliku od @SuppressWarnings("unchecked") na deklaraciji metode, djeluje i na pozive te metode. Ne potiskuje sva upozorenja unutar tijela metode.
U Java SE 21 može se upotrijebiti uz konstruktore varargs i metode varargs označene s static, final ili private. Upotreba uz deklaraciju bez varargsa ili uz metodu koja ne ispunjava te uvjete pogreška je pri kompilaciji. Za reificirljive tipove elemenata, kao što je String, nije potrebna i prevoditelj može izdati upozorenje.
To je autorovo obećanje, a ne dokaz sigurnosti. Nesiguran zapis putem aliasa polja i dalje može uzrokovati ClassCastException. U primjeru totalSize samo čita polje groups, ne zapisuje u njega niti ga izlaže, što opravdava obećanje.
Primjeri
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")));
}
}Rezultat
3
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.