База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

@SafeVarargs — деклариране на безопасна обработка на varargs

`@SafeVarargs` е гаранцията на автора, че даден метод или конструктор обработва безопасно своя параметър varargs. Тя потиска определени unchecked предупреждения при декларацията и местата на извикване, но не проверява и не поправя безопасността на типовете.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

SafeVarargs е анотация от java.lang. Параметърът varargs се обработва като масив. Когато типът на елементите му не е реифицируем, например List<String>, по време на изпълнение не е налична пълната информация за типа. Така възниква риск от замърсяване на heap: стойностите може да не съответстват на декларираните генерични типове.

@SafeVarargs потиска unchecked предупреждението за такава декларация и за създаването на параметризирани масиви при местата на извикване. За разлика от @SuppressWarnings("unchecked") върху декларация на метод, тя влияе и върху извикванията на този метод. Не потиска всички предупреждения в тялото на метода.

В Java SE 21 тя може да се използва при конструктори varargs и методи varargs, означени с static, final или private. Използването ѝ при декларация без varargs или при метод, който не отговаря на тези условия, е грешка при компилация. При реифицируеми типове на елементите, като String, тя е излишна и компилаторът може да издаде предупреждение.

Това е обещание на автора, а не доказателство за безопасност. Небезопасен запис чрез псевдоним на масива все още може да причини ClassCastException. В примера totalSize само чете масива groups, без да записва в него или да го предоставя, което обосновава обещанието.

Примери

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

Резултат

3

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници