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.