CKTIS / Java
@SuppressWarnings — potlačení varování kompilátoru
@SuppressWarnings potlačuje vybrané kategorie varování v anotované deklaraci a jejím obsahu. Kód neopravuje ani nezaručuje typovou bezpečnost; použijte nejmenší účinný rozsah a vysvětlete důvod.
Verze: Java SE 21; repository runtime, production runtime not attested
Syntaxe
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings je anotace, která řídí varování při kompilaci. Má retenci SOURCE, takže se neuchovává v souboru .class. Neodstraňuje chyby kompilace ani rizika za běhu.
Její povinný prvek value má typ String[]: pro jeden název použijte @SuppressWarnings("unchecked"), pro více názvů @SuppressWarnings({"deprecation", "removal"}). "unchecked" se týká operací bez úplné kontroly typů; "deprecation" a "removal" potlačují samostatné kategorie varování týkající se zastaralých API. Java SE 21 vyžaduje také rozpoznávání "preview". Jiné názvy závisí na kompilátoru; neznámé názvy se ignorují, kompilátor však na ně může upozornit.
Anotace se vztahuje na deklaraci a prvky, které obsahuje. Potlačení z okolních deklarací se sčítají. Zvolte nejmenší účinný rozsah, například lokální proměnnou místo celé metody. V Java SE 21 lze anotací @SuppressWarnings označit deklaraci modulu v module-info.java, ale potlačení varování se nevztahuje na typy v modulu. PACKAGE není mezi povolenými cíli anotace, takže její použití na deklaraci balíčku v package-info.java způsobí chybu při kompilaci.
V příkladu není přetypování z Object na List<String> kontrolované. Jeho zdůvodněním je, že source vzniká jako seznam obsahující pouze řetězec. Anotace pouze potlačí varování: pokud se změní původ dat, toto zdůvodnění může přestat platit. Pokud je to možné, odstraňte raději příčinu varování.
Příklady
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));
}
}Výsledek
Java
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.