CKTIS / Java
@SafeVarargs — deklarace bezpečného zpracování varargs
`@SafeVarargs` je zárukou autora, že metoda nebo konstruktor bezpečně zpracovává svůj parametr varargs. Potlačuje určitá unchecked upozornění u deklarace a míst volání, ale typovou bezpečnost nekontroluje ani neopravuje.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs je anotace z java.lang. S parametrem varargs se zachází jako s polem. Pokud jeho typ prvků není reifikovatelný, například List<String>, nejsou za běhu k dispozici úplné informace o typu. Vzniká tak riziko znečištění haldy: hodnoty nemusí odpovídat deklarovaným generickým typům.
@SafeVarargs potlačuje unchecked upozornění týkající se takové deklarace a vytváření parametrizovaných polí v místech volání. Na rozdíl od @SuppressWarnings("unchecked") u deklarace metody působí také na volání této metody. Nepotlačuje všechna upozornění uvnitř těla metody.
V Java SE 21 ji lze použít u konstruktorů varargs a metod varargs označených jako static, final nebo private. Použití u deklarace bez varargs nebo u metody, která tyto podmínky nesplňuje, je chyba kompilace. U reifikovatelných typů prvků, jako je String, je zbytečná a kompilátor může vydat upozornění.
Jde o příslib autora, nikoli o důkaz bezpečnosti. Nebezpečný zápis přes alias pole může stále způsobit ClassCastException. V příkladu metoda totalSize pole groups pouze čte, nezapisuje do něj ani ho nezpřístupňuje, což tento příslib odůvodňuje.
Pří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ýsledek
3
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.