CKTIS / Java
@SuppressWarnings — supprimer les avertissements du compilateur
@SuppressWarnings supprime certaines catégories d’avertissements dans une déclaration annotée et son contenu. Elle ne corrige pas le code et ne garantit pas la sûreté des types ; utilisez la portée efficace la plus réduite possible et expliquez pourquoi.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings est une annotation qui contrôle les avertissements à la compilation. Sa rétention est SOURCE : elle n’est donc pas conservée dans le fichier .class. Elle ne supprime ni les erreurs de compilation ni les risques à l’exécution.
Son élément obligatoire value est de type String[] : utilisez @SuppressWarnings("unchecked") pour un nom ou @SuppressWarnings({"deprecation", "removal"}) pour plusieurs. "unchecked" concerne les opérations qui ne font pas l’objet d’une vérification complète des types ; "deprecation" et "removal" suppriment des catégories distinctes d’avertissements sur les API obsolètes. Java SE 21 exige également la reconnaissance de "preview". Les autres noms dépendent du compilateur ; les noms inconnus sont ignorés, même si le compilateur peut émettre un avertissement à leur sujet.
L’annotation s’applique à sa déclaration et aux éléments qu’elle contient. Les suppressions provenant des déclarations englobantes se cumulent. Choisissez la portée efficace la plus réduite, par exemple une variable locale plutôt qu’une méthode entière. En Java SE 21, @SuppressWarnings peut annoter une déclaration de module dans module-info.java, mais la suppression des avertissements ne s’étend pas aux types du module. PACKAGE ne figure pas parmi les cibles autorisées de cette annotation : l’appliquer à une déclaration de package dans package-info.java provoque une erreur de compilation.
Dans l’exemple, la conversion de Object en List<String> n’est pas vérifiée. Elle se justifie par le fait que source est créé comme une liste contenant uniquement une chaîne. L’annotation ne fait que supprimer l’avertissement : si la provenance des données change, cette justification peut ne plus être valable. Dans la mesure du possible, préférez éliminer la cause de l’avertissement.
Exemples
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));
}
}Résultat
Java
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.