Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes