Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Java

@SuppressWarnings — zatiranje opozoril prevajalnika

@SuppressWarnings zatira izbrane kategorije opozoril v označeni deklaraciji in njeni vsebini. Kode ne popravi in ne zagotavlja varnosti tipov; uporabite najmanjši učinkoviti obseg in pojasnite razlog.

Različica: Java SE 21; repository runtime, production runtime not attested

Sintaksa

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

@SuppressWarnings je anotacija za nadzor opozoril med prevajanjem. Ima hrambo SOURCE, zato se ne ohrani v datoteki .class. Ne odpravlja napak pri prevajanju ali tveganj med izvajanjem.

Njen obvezni element value je tipa String[]: za eno ime uporabite @SuppressWarnings("unchecked"), za več imen pa @SuppressWarnings({"deprecation", "removal"}). "unchecked" zadeva operacije brez popolnega preverjanja tipov; "deprecation" in "removal" zatirata ločeni kategoriji opozoril o zastarelih API-jih. Java SE 21 zahteva tudi prepoznavanje "preview". Druga imena so odvisna od prevajalnika; neznana imena se prezrejo, čeprav lahko prevajalnik nanje opozori.

Anotacija velja za svojo deklaracijo in elemente, ki jih vsebuje. Zatiranja iz nadrejenih deklaracij se seštevajo. Izberite najmanjši učinkoviti obseg, na primer lokalno spremenljivko namesto celotne metode. V Java SE 21 lahko z anotacijo @SuppressWarnings označite deklaracijo modula v module-info.java, vendar to zatiranje opozoril ne velja za tipe v modulu. PACKAGE ni med dovoljenimi cilji anotacije, zato njena uporaba na deklaraciji paketa v package-info.java povzroči napako pri prevajanju.

V primeru pretvorba iz Object v List<String> ni preverjena. Utemeljena je s tem, da je source ustvarjen kot seznam, ki vsebuje samo niz. Anotacija zgolj zatira opozorilo: če se spremeni izvor podatkov, ta utemeljitev morda ne bo več veljavna. Kadar je mogoče, raje odpravite vzrok opozorila.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri