Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / Java

@SuppressWarnings — potiskivanje upozorenja prevoditelja

@SuppressWarnings potiskuje odabrane kategorije upozorenja u anotiranoj deklaraciji i njezinu sadržaju. Ne popravlja kod niti jamči sigurnost tipova; upotrijebite najmanji učinkoviti opseg i objasnite razlog.

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

Sintaksa

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

@SuppressWarnings je anotacija za upravljanje upozorenjima pri prevođenju. Ima zadržavanje SOURCE, pa se ne pohranjuje u datoteci .class. Ne uklanja pogreške pri prevođenju ni rizike tijekom izvođenja.

Njezin obvezni element value ima tip String[]: za jedan naziv upotrijebite @SuppressWarnings("unchecked"), a za više njih @SuppressWarnings({"deprecation", "removal"}). "unchecked" odnosi se na operacije bez potpune provjere tipova; "deprecation" i "removal" potiskuju zasebne kategorije upozorenja o zastarjelim API-jima. Java SE 21 zahtijeva i prepoznavanje "preview". Ostali nazivi ovise o prevoditelju; nepoznati nazivi zanemaruju se, iako prevoditelj može izdati upozorenje o njima.

Anotacija se odnosi na svoju deklaraciju i elemente koje ona sadrži. Potiskivanja iz obuhvaćajućih deklaracija zbrajaju se. Odaberite najmanji učinkoviti opseg, primjerice lokalnu varijablu umjesto cijele metode. U Javi SE 21 anotacijom @SuppressWarnings može se označiti deklaracija modula u module-info.java, ali to potiskivanje upozorenja ne odnosi se na tipove u modulu. PACKAGE nije među dopuštenim ciljevima anotacije, pa njezina primjena na deklaraciju paketa u package-info.java uzrokuje pogrešku pri prevođenju.

U primjeru pretvorba iz Object u List<String> nije provjerena. Njezino je opravdanje to što je source stvoren kao popis koji sadrži samo niz znakova. Anotacija samo potiskuje upozorenje: ako se promijeni izvor podataka, to opravdanje možda više neće vrijediti. Kad god je moguće, radije uklonite uzrok upozorenja.

Primjeri

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));
    }
}

Rezultat

Java

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori