CKTIS / Java
@SafeVarargs — declarar o tratamento seguro de varargs
`@SafeVarargs` é a garantia do autor de que um método ou construtor trata o seu parâmetro varargs de forma segura. Suprime determinados avisos unchecked na declaração e nos locais de chamada, mas não verifica nem corrige a segurança dos tipos.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs é uma anotação de java.lang. Um parâmetro varargs é tratado como um array. Quando o tipo dos seus elementos não é reificável, como List<String>, não estão disponíveis todas as informações de tipo durante a execução. Isto cria o risco de heap pollution: os valores podem não corresponder aos tipos genéricos declarados.
@SafeVarargs suprime o aviso unchecked relativo a essa declaração e à criação de arrays parametrizados nos locais de chamada. Ao contrário de @SuppressWarnings("unchecked") numa declaração de método, também se aplica às chamadas desse método. Não suprime todos os avisos no corpo do método.
Em Java SE 21, pode ser usada em construtores varargs e em métodos varargs marcados como static, final ou private. Usá-la numa declaração sem varargs, ou num método que não satisfaça estas condições, é um erro de compilação. Para tipos de elementos reificáveis, como String, é desnecessária e o compilador pode emitir um aviso.
É uma promessa do autor, não uma prova de segurança. Uma escrita insegura através de um alias do array ainda pode causar uma ClassCastException. No exemplo, totalSize limita-se a ler o array groups, sem escrever nele nem o expor, o que justifica a promessa.
Exemplos
import java.util.List;
public class Main {
@SafeVarargs
static int totalSize(List<String>... groups) {
int total = 0;
for (List<String> group : groups) {
total += group.size();
}
return total;
}
public static void main(String[] args) {
System.out.println(totalSize(List.of("A", "B"), List.of("C")));
}
}Resultado
3
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.