Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje