Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

@SafeVarargs — deklariranje varne obravnave varargs

`@SafeVarargs` je zagotovilo avtorja, da metoda ali konstruktor varno obravnava svoj parameter varargs. Zatre določena opozorila unchecked pri deklaraciji in mestih klica, vendar varnosti tipov ne preveri ali popravi.

Različica: 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. Parameter varargs se obravnava kot polje. Če njegov tip elementov ni reificirljiv, na primer List<String>, med izvajanjem niso na voljo vse informacije o tipu. Tako nastane tveganje onesnaženja kopice: vrednosti se morda ne ujemajo z deklariranimi generičnimi tipi.

@SafeVarargs zatre opozorilo unchecked, ki se nanaša na takšno deklaracijo in ustvarjanje parametriziranih polj na mestih klica. V nasprotju z @SuppressWarnings("unchecked") pri deklaraciji metode vpliva tudi na klice te metode. Ne zatre vseh opozoril v telesu metode.

V Java SE 21 jo je mogoče uporabiti pri konstruktorjih varargs in metodah varargs z oznako static, final ali private. Uporaba pri deklaraciji brez varargs ali pri metodi, ki teh pogojev ne izpolnjuje, je napaka pri prevajanju. Pri reificirljivih tipih elementov, kot je String, je odveč, zato lahko prevajalnik izda opozorilo.

To je avtorjeva obljuba, ne dokaz varnosti. Nevaren zapis prek vzdevka polja lahko še vedno povzroči ClassCastException. V primeru totalSize polje groups samo bere, vanj ne zapisuje in ga ne izpostavlja, kar obljubo upravičuje.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri