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.