Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

@SafeVarargs — dichiarare una gestione sicura di varargs

`@SafeVarargs` è la garanzia dell’autore che un metodo o un costruttore gestisca in modo sicuro il proprio parametro varargs. Sopprime specifici avvisi unchecked nella dichiarazione e nei punti di chiamata, ma non verifica né ripristina la sicurezza dei tipi.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }

SafeVarargs è un’annotazione di java.lang. Un parametro varargs viene gestito come un array. Quando il tipo dei suoi elementi non è reificabile, per esempio List<String>, durante l’esecuzione non sono disponibili tutte le informazioni sui tipi. Si crea così il rischio di heap pollution: i valori potrebbero non corrispondere ai tipi generici dichiarati.

@SafeVarargs sopprime l’avviso unchecked relativo a una dichiarazione di questo tipo e alla creazione di array parametrizzati nei punti di chiamata. A differenza di @SuppressWarnings("unchecked") applicato alla dichiarazione di un metodo, ha effetto anche sulle chiamate a quel metodo. Non sopprime tutti gli avvisi all’interno del corpo del metodo.

In Java SE 21 può essere applicata ai costruttori varargs e ai metodi varargs contrassegnati static, final o private. Usarla su una dichiarazione senza varargs, o su un metodo che non soddisfa queste condizioni, è un errore di compilazione. Per tipi di elementi reificabili come String è superflua e il compilatore può generare un avviso.

È una promessa dell’autore, non una prova di sicurezza. Una scrittura non sicura tramite un alias dell’array può comunque causare una ClassCastException. Nell’esempio, totalSize legge soltanto l’array groups, senza scriverci né esporlo: questo giustifica la promessa.

Esempi

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")));
    }
}

Risultato

3

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti