Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / Java

@SuppressWarnings — potlačenie upozornení kompilátora

@SuppressWarnings potláča vybrané kategórie upozornení v anotovanej deklarácii a jej obsahu. Kód neopravuje ani nezaručuje typovú bezpečnosť; použite najmenší účinný rozsah a vysvetlite dôvod.

Verzia: Java SE 21; repository runtime, production runtime not attested

Syntax

@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})

@SuppressWarnings je anotácia, ktorá riadi upozornenia pri kompilácii. Má retenciu SOURCE, takže sa neuchováva v súbore .class. Neodstraňuje chyby kompilácie ani riziká za behu.

Jej povinný prvok value má typ String[]: pre jeden názov použite @SuppressWarnings("unchecked"), pre viac názvov @SuppressWarnings({"deprecation", "removal"}). "unchecked" sa týka operácií bez úplnej kontroly typov; "deprecation" a "removal" potláčajú samostatné kategórie upozornení týkajúcich sa zastaraných API. Java SE 21 vyžaduje aj rozpoznávanie "preview". Iné názvy závisia od kompilátora; neznáme názvy sa ignorujú, kompilátor však na ne môže upozorniť.

Anotácia sa vzťahuje na deklaráciu a prvky, ktoré obsahuje. Potlačenia z okolitých deklarácií sa sčítavajú. Vyberte najmenší účinný rozsah, napríklad lokálnu premennú namiesto celej metódy. V Java SE 21 možno anotáciou @SuppressWarnings označiť deklaráciu modulu v module-info.java, ale potlačenie upozornení sa nevzťahuje na typy v module. PACKAGE nie je medzi povolenými cieľmi anotácie, takže jej použitie na deklarácii balíka v package-info.java spôsobí chybu pri kompilácii.

V príklade nie je pretypovanie z Object na List<String> kontrolované. Jeho zdôvodnením je, že source vzniká ako zoznam obsahujúci iba reťazec. Anotácia iba potláča upozornenie: ak sa zmení pôvod údajov, toto zdôvodnenie môže prestať platiť. Ak je to možné, radšej odstráňte príčinu upozornenia.

Prí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ýsledok

Java

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje