CKTIS / Java
@SuppressWarnings — suprimir advertencias del compilador
@SuppressWarnings suprime categorías de advertencias seleccionadas en una declaración anotada y su contenido. No corrige el código ni garantiza la seguridad de tipos; utiliza el ámbito eficaz más reducido posible y explica el motivo.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings es una anotación que controla las advertencias en tiempo de compilación. Tiene retención SOURCE, por lo que no se conserva en el archivo .class. No elimina errores de compilación ni riesgos en tiempo de ejecución.
Su elemento obligatorio value es de tipo String[]: usa @SuppressWarnings("unchecked") para un nombre o @SuppressWarnings({"deprecation", "removal"}) para varios. "unchecked" se refiere a operaciones sin comprobación completa de tipos; "deprecation" y "removal" suprimen categorías distintas de advertencias sobre API obsoletas. Java SE 21 también exige reconocer "preview". Otros nombres dependen del compilador; los nombres desconocidos se ignoran, aunque el compilador puede advertir sobre ellos.
La anotación se aplica a su declaración y a los elementos que contiene. Las supresiones de las declaraciones envolventes se acumulan. Elige el ámbito eficaz más reducido, por ejemplo, una variable local en vez de un método entero. En Java SE 21, @SuppressWarnings puede aplicarse a una declaración de módulo en module-info.java, pero la supresión no se extiende a los tipos del módulo. PACKAGE no figura entre los destinos permitidos de la anotación, por lo que aplicarla a una declaración de paquete en package-info.java provoca un error de compilación.
En el ejemplo, la conversión de Object a List<String> no está comprobada. Se justifica porque source se crea como una lista que contiene únicamente una cadena. La anotación solo suprime la advertencia: si cambia el origen de los datos, esa justificación podría dejar de ser válida. Siempre que sea posible, es preferible eliminar la causa de una advertencia.
Ejemplos
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));
}
}Resultado
Java
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.