CKTIS / Java
@SuppressWarnings — Compilerwarnungen unterdrücken
@SuppressWarnings unterdrückt ausgewählte Warnungskategorien in einer annotierten Deklaration und ihren Inhalten. Die Annotation behebt weder den Code noch garantiert sie Typsicherheit; verwende den kleinstmöglichen wirksamen Geltungsbereich und erkläre den Grund.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings ist eine Annotation zur Steuerung von Compilerwarnungen. Sie hat die Retention SOURCE und wird daher nicht in der .class-Datei gespeichert. Sie beseitigt weder Kompilierungsfehler noch Risiken zur Laufzeit.
Ihr erforderliches Element value hat den Typ String[]: Für einen Namen kannst du @SuppressWarnings("unchecked") und für mehrere @SuppressWarnings({"deprecation", "removal"}) verwenden. "unchecked" betrifft Vorgänge ohne vollständige Typprüfung; "deprecation" und "removal" unterdrücken getrennte Kategorien von Warnungen zu veralteten APIs. Java SE 21 erfordert außerdem, dass "preview" erkannt wird. Andere Namen hängen vom Compiler ab; unbekannte Namen werden ignoriert, auch wenn der Compiler davor warnen kann.
Die Annotation gilt für ihre Deklaration und die darin enthaltenen Elemente. Unterdrückungen aus umgebenden Deklarationen addieren sich. Wähle den kleinsten wirksamen Geltungsbereich, beispielsweise eine lokale Variable statt einer ganzen Methode. In Java SE 21 kannst du eine Moduldeklaration in module-info.java mit @SuppressWarnings annotieren, doch diese Unterdrückung erstreckt sich nicht auf die Typen im Modul. PACKAGE ist kein zulässiges Ziel dieser Annotation. Ihre Verwendung an einer Paketdeklaration in package-info.java führt daher zu einem Kompilierungsfehler.
Im Beispiel ist die Umwandlung von Object zu List<String> nicht überprüft. Ihre Rechtfertigung ergibt sich daraus, dass source als Liste erstellt wird, die nur eine Zeichenfolge enthält. Die Annotation unterdrückt lediglich die Warnung: Wenn sich die Herkunft der Daten ändert, kann diese Rechtfertigung hinfällig werden. Wenn möglich, solltest du die Ursache einer Warnung beseitigen.
Beispiele
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));
}
}Ergebnis
Java
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.