KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

@SafeVarargs — veilige varargs-verwerking declareren

`@SafeVarargs` is de verzekering van de auteur dat een methode of constructor de varargs-parameter veilig verwerkt. De annotatie onderdrukt bepaalde unchecked-waarschuwingen bij de declaratie en aanroepplaatsen, maar controleert of herstelt de typeveiligheid niet.

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

Syntax

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

SafeVarargs is een annotatie uit java.lang. Een varargs-parameter wordt als een array verwerkt. Als het elementtype niet reïficeerbaar is, bijvoorbeeld List<String>, is tijdens runtime niet alle type-informatie beschikbaar. Daardoor ontstaat het risico op heap pollution: waarden komen mogelijk niet overeen met hun gedeclareerde generieke typen.

@SafeVarargs onderdrukt de unchecked-waarschuwing over zo’n declaratie en over het aanmaken van geparametriseerde arrays bij aanroepplaatsen. Anders dan @SuppressWarnings("unchecked") op een methodedeclaratie werkt de annotatie ook door bij aanroepen van die methode. Ze onderdrukt niet elke waarschuwing in de methodebody.

In Java SE 21 kan de annotatie worden gebruikt bij varargs-constructors en varargs-methoden met de aanduiding static, final of private. Gebruik bij een declaratie zonder varargs of bij een methode die niet aan deze voorwaarden voldoet, is een compilatiefout. Voor reïficeerbare elementtypen zoals String is de annotatie overbodig; de compiler kan dan een waarschuwing geven.

Dit is een belofte van de auteur, geen bewijs van veiligheid. Een onveilige schrijfoperatie via een array-alias kan nog steeds een ClassCastException veroorzaken. In het voorbeeld leest totalSize de array groups alleen; de methode schrijft er niet in en stelt de array niet beschikbaar. Dat rechtvaardigt de belofte.

Voorbeelden

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

Resultaat

3

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen