Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

@SuppressWarnings — wyciszanie ostrzeżeń kompilatora

@SuppressWarnings wycisza wskazane rodzaje ostrzeżeń w oznaczonej deklaracji i jej zawartości. Nie naprawia kodu ani nie zapewnia bezpieczeństwa typów; stosuj ją w możliwie najmniejszym zakresie i wyjaśnij powód.

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

Składnia

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

@SuppressWarnings to adnotacja sterująca ostrzeżeniami podczas kompilacji. Ma retencję SOURCE, więc nie jest zachowywana w pliku .class. Nie usuwa błędów kompilacji ani zagrożeń w czasie wykonania.

Wymagany element value ma typ String[]: dla jednej nazwy można użyć @SuppressWarnings("unchecked"), a dla kilku — @SuppressWarnings({"deprecation", "removal"}). "unchecked" dotyczy operacji bez pełnej kontroli typów; "deprecation" i "removal" wyciszają oddzielne kategorie ostrzeżeń o przestarzałych API. Java SE 21 wymaga także rozpoznawania "preview". Inne nazwy zależą od kompilatora; nieznane są ignorowane, choć kompilator może o nich ostrzec.

Adnotacja obejmuje deklarację i zawarte w niej elementy. Wyciszenia z otaczających deklaracji sumują się. Wybieraj najmniejszy skuteczny zakres, np. zmienną lokalną zamiast całej metody. W Java SE 21 można oznaczyć deklarację modułu w module-info.java adnotacją @SuppressWarnings, ale to wyciszenie nie obejmuje typów należących do modułu. Lista dozwolonych celów adnotacji nie zawiera PACKAGE, więc użycie jej na deklaracji pakietu w package-info.java powoduje błąd kompilacji.

W przykładzie rzutowanie z Object na List<String> jest niekontrolowane. Uzasadnienie wynika z utworzenia source jako listy zawierającej wyłącznie napis. Adnotacja tylko wycisza ostrzeżenie: po zmianie pochodzenia danych to uzasadnienie może przestać obowiązywać. Preferuj usunięcie przyczyny ostrzeżenia, jeśli jest to możliwe.

Przykłady

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

Wynik

Java

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła