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

CKTIS / Java

Параметри varargs в Java: String... и T...

В Java SE 21 параметър varargs приема отделни аргументи или готов масив. При `T...` изтриването на типовете създава риск от замърсяване на хийпа.

Версия: Java SE 21

Синтаксис

static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }

В Java SE 21 ... след типа обозначава параметър varargs. Метод или конструктор може да има най-много един такъв параметър и той трябва да е последен. В тялото на метода String... values е от тип String[], а в обобщен метод с типов параметър <T> записът T... values е от тип T[].

При извикване с променлив брой аргументи компилаторът осигурява събирането на последните аргументи в нов масив. labels() получава празен масив, а не null. Ако извикването е възможно без събиране на аргументи, съвместимият масив се подава без копиране и извикващият код вижда промените в елементите му. За показания метод labels(null) и labels((String[]) null) подават нулева референция вместо масив; четенето на length би предизвикало NullPointerException. labels((String) null) подава масив с един елемент null.

При избор на претоварен метод компилаторът първо търси съвпадение без събиране на аргументите: най-напред без boxing и unboxing, после с разрешени преобразувания от двата вида. Само ако и двете фази не намерят приложим метод, се разглежда събирането. Затова метод varargs може да бъде избран във фаза с фиксиран брой аргументи. labels(String...) и labels(String[]) имат еднаква сигнатура и не могат да бъдат отделни претоварени методи.

String е реифицируем тип: типът му е напълно достъпен по време на изпълнение. T не е реифицируем; при събиране на аргументите новият масив използва типа, получен след изтриване на определения за извикването тип на масива. Компилаторът издава предупреждение unchecked при декларацията и може да предупреди и при извикване. Ако същият масив е достъпен чрез референция от тип Object[], запис в него може да наруши гаранциите на обобщените типове. Това замърсяване на хийпа може да се прояви чак при четене като ClassCastException.

@SafeVarargs е уверение от автора, а не проверка по време на изпълнение. Анотацията потиска тези предупреждения при декларацията и на местата на извикване. Допустима е за конструктори varargs и за методи varargs, означени със static, final или private. Използвай я само след проверка, че масивът не се използва и не се предоставя по опасен начин.

Примери

import java.util.Arrays;
import java.util.List;

public class VarargsDemo {
    static void labels(String... values) {
        System.out.println(Arrays.toString(values));
    }

    @SafeVarargs
    static <T> int count(T... values) {
        return values.length;
    }

    public static void main(String[] args) {
        labels();
        labels("red", "blue");
        labels(new String[]{"green"});
        labels((String) null);
        labels((String[]) null);
        System.out.println(count(List.of("red", "blue"), List.of("green")));
    }
}

Резултат

[]
[red, blue]
[green]
[null]
null
2

`[]` е празен масив, `[null]` е масив с един елемент `null`, а `null` означава, че няма масив. `count` чете само дължината на масива: брои два списъка, а не три низа.

Свързани уроци

  • Java · Урок 3 · Напреднало · Версия: 2
  • Java · Урок 14 · Напреднало · Версия: 2

Източници