Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori