CKTIS / Java
@SuppressWarnings — потискане на предупрежденията на компилатора
@SuppressWarnings потиска избрани категории предупреждения в анотирана декларация и съдържанието ѝ. Не поправя кода и не гарантира типова безопасност; използвайте възможно най-малкия ефективен обхват и обяснете причината.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings е анотация, която управлява предупрежденията по време на компилация. Тя има ретенция SOURCE, затова не се запазва във файла .class. Не премахва грешки при компилация или рискове по време на изпълнение.
Задължителният ѝ елемент value е от тип String[]: за едно име използвайте @SuppressWarnings("unchecked"), а за няколко — @SuppressWarnings({"deprecation", "removal"}). "unchecked" се отнася до операции без пълна проверка на типовете; "deprecation" и "removal" потискат отделни категории предупреждения за остарели API. Java SE 21 изисква и разпознаване на "preview". Другите имена зависят от компилатора; непознатите се игнорират, макар че компилаторът може да предупреди за тях.
Анотацията обхваща декларацията и елементите, които тя съдържа. Потисканията от обхващащи декларации се натрупват. Изберете най-малкия ефективен обхват, например локална променлива вместо цял метод. В Java SE 21 @SuppressWarnings може да се приложи към декларация на модул в module-info.java, но така не се потискат предупрежденията за типовете в модула. PACKAGE не е сред допустимите цели на анотацията, затова прилагането ѝ към декларация на пакет в package-info.java води до грешка при компилация.
В примера преобразуването от Object към List<String> не е проверено. То е обосновано от това, че source е създаден като списък, съдържащ само низ. Анотацията само потиска предупреждението: ако произходът на данните се промени, тази обосновка може вече да не е валидна. Когато е възможно, предпочитайте да отстраните причината за предупреждението.
Примери
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));
}
}Резултат
Java
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.