Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

@SafeVarargs — déclarer une gestion sûre des varargs

`@SafeVarargs` est l’assurance de l’auteur qu’une méthode ou un constructeur gère son paramètre varargs de manière sûre. Elle supprime certains avertissements unchecked sur la déclaration et aux sites d’appel, mais ne vérifie ni ne rétablit la sûreté des types.

Version : Java SE 21; repository runtime, production runtime not attested

Syntaxe

@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }

SafeVarargs est une annotation de java.lang. Un paramètre varargs est traité comme un tableau. Lorsque son type d’élément n’est pas réifiable, comme List<String>, les informations de type complètes ne sont pas disponibles à l’exécution. Il existe alors un risque de pollution du tas : les valeurs peuvent ne pas correspondre aux types génériques déclarés.

@SafeVarargs supprime l’avertissement unchecked concernant une telle déclaration ainsi que la création de tableaux paramétrés aux sites d’appel. Contrairement à @SuppressWarnings("unchecked") sur une déclaration de méthode, elle s’applique aussi aux appels de cette méthode. Elle ne supprime pas tous les avertissements dans le corps de la méthode.

En Java SE 21, elle peut annoter les constructeurs varargs et les méthodes varargs marquées static, final ou private. L’utiliser sur une déclaration sans varargs, ou sur une méthode qui ne remplit pas ces conditions, constitue une erreur de compilation. Pour des types d’élément réifiables comme String, elle est inutile et le compilateur peut émettre un avertissement.

C’est une promesse de l’auteur, et non une preuve de sûreté. Une écriture dangereuse via un alias de tableau peut toujours provoquer une ClassCastException. Dans l’exemple, totalSize ne fait que lire le tableau groups : elle n’y écrit pas et ne l’expose pas, ce qui justifie cette promesse.

Exemples

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")));
    }
}

Résultat

3

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources