CKTIS / Java
@SafeVarargs — declarar un manejo seguro de varargs
`@SafeVarargs` es la garantía del autor de que un método o constructor maneja su parámetro varargs de forma segura. Suprime ciertas advertencias unchecked en la declaración y en los puntos de llamada, pero no comprueba ni repara la seguridad de tipos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs es una anotación de java.lang. Un parámetro varargs se maneja como una matriz. Cuando su tipo de elemento no es reificable, como List<String>, no se dispone de toda la información de tipos durante la ejecución. Esto crea el riesgo de contaminación del heap: los valores pueden no coincidir con los tipos genéricos declarados.
@SafeVarargs suprime la advertencia unchecked sobre esa declaración y sobre la creación de matrices parametrizadas en los puntos de llamada. A diferencia de @SuppressWarnings("unchecked") en una declaración de método, también afecta a las llamadas a dicho método. No suprime todas las advertencias del cuerpo del método.
En Java SE 21, puede anotarse en constructores varargs y en métodos varargs marcados como static, final o private. Usarla en una declaración sin varargs o en un método que no cumpla estas condiciones es un error de compilación. Para tipos de elemento reificables, como String, es innecesaria y el compilador puede emitir una advertencia.
Es una promesa del autor, no una prueba de seguridad. Una escritura insegura mediante un alias de matriz todavía puede causar una ClassCastException. En el ejemplo, totalSize solo lee la matriz groups; no escribe en ella ni la expone, lo que justifica la promesa.
Ejemplos
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
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.