База знанияИзпитен център
BGБългарски
Избери език13

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

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници