CKTIS / Java
@SuppressWarnings — compilerwaarschuwingen onderdrukken
@SuppressWarnings onderdrukt geselecteerde waarschuwingscategorieën in een geannoteerde declaratie en de inhoud ervan. De annotatie herstelt de code niet en garandeert geen typeveiligheid; gebruik het kleinst werkzame bereik en leg de reden uit.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings is een annotatie waarmee je compilerwaarschuwingen beheert. De retentie is SOURCE, dus de annotatie wordt niet bewaard in het .class-bestand. Ze verwijdert geen compilatiefouten en neemt geen risico’s tijdens runtime weg.
Het verplichte element value heeft het type String[]: gebruik @SuppressWarnings("unchecked") voor één naam en @SuppressWarnings({"deprecation", "removal"}) voor meerdere namen. "unchecked" betreft bewerkingen zonder volledige typecontrole; "deprecation" en "removal" onderdrukken afzonderlijke categorieën waarschuwingen over verouderde API’s. Java SE 21 vereist ook dat "preview" wordt herkend. Andere namen zijn afhankelijk van de compiler; onbekende namen worden genegeerd, al kan de compiler er een waarschuwing over geven.
De annotatie geldt voor de declaratie en de elementen die deze bevat. Onderdrukkingen van omringende declaraties stapelen zich op. Kies het kleinst werkzame bereik, bijvoorbeeld een lokale variabele in plaats van een hele methode. In Java SE 21 kun je een moduledeclaratie in module-info.java annoteren met @SuppressWarnings, maar die onderdrukking geldt niet voor typen in de module. PACKAGE is geen toegestaan doel voor deze annotatie. Gebruik je haar op een pakketdeclaratie in package-info.java, dan krijg je een compilatiefout.
In het voorbeeld is de cast van Object naar List<String> niet gecontroleerd. De rechtvaardiging is dat source wordt aangemaakt als een lijst met uitsluitend een tekenreeks. De annotatie onderdrukt alleen de waarschuwing: als de herkomst van de gegevens verandert, kan die rechtvaardiging ongeldig worden. Verwijder waar mogelijk liever de oorzaak van een waarschuwing.
Voorbeelden
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));
}
}Resultaat
Java
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.