Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

@SuppressWarnings — sopprimere gli avvisi del compilatore

@SuppressWarnings sopprime determinate categorie di avvisi in una dichiarazione annotata e nei suoi contenuti. Non corregge il codice né garantisce la sicurezza dei tipi; usa l’ambito efficace più ristretto possibile e spiega il motivo.

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

Sintassi

@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})

@SuppressWarnings è un’annotazione che controlla gli avvisi in fase di compilazione. Ha retention SOURCE, quindi non viene conservata nel file .class. Non elimina gli errori di compilazione né i rischi in fase di esecuzione.

Il suo elemento obbligatorio value è di tipo String[]: usa @SuppressWarnings("unchecked") per un nome o @SuppressWarnings({"deprecation", "removal"}) per più nomi. "unchecked" riguarda operazioni senza controllo completo dei tipi; "deprecation" e "removal" sopprimono categorie distinte di avvisi sulle API obsolete. Java SE 21 richiede anche il riconoscimento di "preview". Gli altri nomi dipendono dal compilatore; quelli sconosciuti vengono ignorati, anche se il compilatore può segnalarli con un avviso.

L’annotazione si applica alla propria dichiarazione e agli elementi che contiene. Le soppressioni delle dichiarazioni che la racchiudono si sommano. Scegli l’ambito efficace più ristretto, ad esempio una variabile locale invece di un intero metodo. In Java SE 21, @SuppressWarnings può essere applicata a una dichiarazione di modulo in module-info.java, ma la soppressione non si estende ai tipi del modulo. PACKAGE non è tra i target consentiti dell’annotazione, quindi applicarla a una dichiarazione di pacchetto in package-info.java provoca un errore di compilazione.

Nell’esempio, il cast da Object a List<String> non è verificato. La sua giustificazione deriva dal fatto che source viene creato come una lista contenente solo una stringa. L’annotazione si limita a sopprimere l’avviso: se cambia la provenienza dei dati, la giustificazione potrebbe non essere più valida. Quando possibile, è preferibile eliminare la causa di un avviso.

Esempi

import java.util.List;

public class Main {
    public static void main(String[] args) {
        Object source = List.of("Java");
        // source is created above as a list containing only strings.
        @SuppressWarnings("unchecked")
        List<String> words = (List<String>) source;
        System.out.println(words.get(0));
    }
}

Risultato

Java

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