CKTIS / Java
@SafeVarargs — deklarovanie bezpečného spracovania varargs
`@SafeVarargs` je zárukou autora, že metóda alebo konštruktor bezpečne spracúva svoj parameter varargs. Potláča určité upozornenia unchecked pri deklarácii a na miestach volania, no typovú bezpečnosť nekontroluje ani neopravuje.
Verzia: Java SE 21; repository runtime, production runtime not attested
Syntax
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs je anotácia z java.lang. S parametrom varargs sa zaobchádza ako s poľom. Ak jeho typ prvkov nie je reifikovateľný, napríklad List<String>, za behu nie sú dostupné úplné informácie o type. Vzniká tak riziko znečistenia haldy: hodnoty nemusia zodpovedať deklarovaným generickým typom.
@SafeVarargs potláča upozornenie unchecked týkajúce sa takejto deklarácie a vytvárania parametrizovaných polí na miestach volania. Na rozdiel od @SuppressWarnings("unchecked") pri deklarácii metódy pôsobí aj na volania tejto metódy. Nepotláča všetky upozornenia v tele metódy.
V Java SE 21 ju možno použiť pri konštruktoroch varargs a metódach varargs označených ako static, final alebo private. Použitie pri deklarácii bez varargs alebo pri metóde, ktorá tieto podmienky nespĺňa, je chyba kompilácie. Pri reifikovateľných typoch prvkov, ako je String, je zbytočná a kompilátor môže vydať upozornenie.
Je to prísľub autora, nie dôkaz bezpečnosti. Nebezpečný zápis cez alias poľa môže stále spôsobiť ClassCastException. V príklade metóda totalSize pole groups iba číta, nezapisuje doň ani ho nesprístupňuje, čo tento prísľub odôvodňuje.
Príklady
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")));
}
}Výsledok
3
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.