CKTIS / Java
@SuppressWarnings — suprimir avisos do compilador
@SuppressWarnings suprime categorias de avisos selecionadas numa declaração anotada e no respetivo conteúdo. Não corrige o código nem garante a segurança dos tipos; utilize o âmbito eficaz mais reduzido possível e explique o motivo.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
@SuppressWarnings("unchecked")
@SuppressWarnings({"deprecation", "removal"})
@SuppressWarnings(value = {"unchecked"})@SuppressWarnings é uma anotação que controla os avisos durante a compilação. Tem retenção SOURCE, pelo que não é guardada no ficheiro .class. Não elimina erros de compilação nem riscos em tempo de execução.
O seu elemento obrigatório value tem o tipo String[]: utilize @SuppressWarnings("unchecked") para um nome ou @SuppressWarnings({"deprecation", "removal"}) para vários. "unchecked" diz respeito a operações sem verificação completa dos tipos; "deprecation" e "removal" suprimem categorias distintas de avisos sobre APIs obsoletas. Java SE 21 exige também o reconhecimento de "preview". Os outros nomes dependem do compilador; os nomes desconhecidos são ignorados, embora o compilador possa emitir um aviso sobre eles.
A anotação abrange a declaração e os elementos nela contidos. As supressões de declarações envolventes acumulam-se. Escolha o âmbito eficaz mais reduzido, por exemplo, uma variável local em vez de um método inteiro. Em Java SE 21, @SuppressWarnings pode ser aplicada a uma declaração de módulo em module-info.java, mas a supressão não abrange os tipos do módulo. PACKAGE não consta da lista de alvos permitidos para a anotação, pelo que aplicá-la a uma declaração de pacote em package-info.java provoca um erro de compilação.
No exemplo, a conversão de Object para List<String> não é verificada. A sua justificação decorre de source ser criado como uma lista que contém apenas uma cadeia de caracteres. A anotação limita-se a suprimir o aviso: se a origem dos dados mudar, essa justificação pode deixar de ser válida. Sempre que possível, prefira eliminar a causa de um aviso.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.