CKTIS / Java
@SafeVarargs — deklaracja bezpiecznej obsługi varargs
`@SafeVarargs` to zapewnienie autora, że metoda lub konstruktor bezpiecznie obsługuje parametr varargs. Wycisza określone ostrzeżenia unchecked w deklaracji i miejscach wywołania, ale nie sprawdza ani nie naprawia bezpieczeństwa typów.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
@SafeVarargs
static <T> void inspect(T... values) { /* safe handling of values */ }SafeVarargs jest adnotacją z java.lang. Parametr varargs jest obsługiwany jako tablica. Gdy typ jego elementów jest niereifikowalny, np. List<String>, pełna informacja o typie nie jest dostępna podczas wykonania. Powstaje ryzyko zanieczyszczenia sterty: wartości mogą nie odpowiadać zadeklarowanym typom generycznym.
@SafeVarargs wycisza ostrzeżenie unchecked dotyczące takiej deklaracji oraz tworzenia tablicy typów parametryzowanych w miejscach wywołania. W przeciwieństwie do @SuppressWarnings("unchecked") na deklaracji metody działa także na jej wywołania. Nie wycisza wszystkich ostrzeżeń w ciele metody.
W Java SE 21 można ją stosować do konstruktorów varargs oraz metod varargs oznaczonych static, final lub private. Użycie przy deklaracji bez varargs albo przy metodzie niespełniającej tych warunków jest błędem kompilacji. Dla reifikowalnych typów elementów, takich jak String, jest zbędna i kompilator może ostrzegać.
To obietnica autora, nie dowód bezpieczeństwa. Niebezpieczny zapis przez alias tablicy może nadal spowodować ClassCastException. W przykładzie totalSize tylko odczytuje tablicę groups, nie zapisuje do niej ani jej nie udostępnia, więc uzasadnia tę obietnicę.
Przykłady
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")));
}
}Wynik
3
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.