CKTIS / Java
Parametre varargs v Jave: String... a T...
V Java SE 21 možno parametru varargs odovzdať jednotlivé argumenty alebo existujúce pole. Pri `T...` môže vymazávanie typov viesť k znečisteniu haldy.
Verzia: Java SE 21
Syntax
static void labels(String... values) { /* values has type String[] */ }
static <T> int count(T... values) { return values.length; }V Java SE 21 označuje zápis ... za typom parameter varargs. Metóda alebo konštruktor môže mať najviac jeden takýto parameter a musí byť posledný. V tele metódy má String... values typ String[]; v generickej metóde s typovým parametrom <T> má T... values typ T[].
Pri volaní s premenlivým počtom argumentov kompilátor zabezpečí, aby sa koncové argumenty zabalili do nového poľa. labels() dostane prázdne pole, nie null. Ak volanie vyhovuje bez zabalenia, kompatibilné pole sa odovzdá bez kopírovania: zmeny jeho prvkov vidí aj volajúci. Pri uvedenej metóde labels(null) a labels((String[]) null) odovzdávajú nulovú referenciu na pole; čítanie length by vyvolalo NullPointerException. labels((String) null) odovzdá pole s jedným prvkom null.
Pri výbere preťaženej metódy kompilátor najprv hľadá zhodu bez zabalenia: najskôr bez boxingu a unboxingu, potom pri povolení oboch. Zabalenie zvažuje, až keď ani jedna fáza nenájde použiteľnú metódu. Metóda varargs sa teda môže vybrať už vo fáze s pevným počtom argumentov. labels(String...) a labels(String[]) majú rovnakú signatúru a nemôžu byť samostatnými preťaženiami.
String je reifikovateľný typ: jeho typ je úplne dostupný za behu. T nie je reifikovateľný; pri zabalení má nové pole typ získaný vymazaním typu poľa určeného pre dané volanie. Kompilátor vydá upozornenie unchecked pri deklarácii a môže upozorniť aj pri volaní. Ak na rovnaké pole odkazuje referencia typu Object[], zápis môže porušiť záruky generických typov. Toto znečistenie haldy sa môže prejaviť až pri čítaní ako ClassCastException.
@SafeVarargs je vyhlásenie autora, nie kontrola za behu. Potláča tieto upozornenia pri deklarácii aj na miestach volania. Je povolená na konštruktoroch varargs a na metódach varargs označených static, final alebo private. Použi ju až po overení, že sa pole nepoužíva ani nesprístupňuje nebezpečným spôsobom.
Príklady
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")));
}
}Výsledok
[] [red, blue] [green] [null] null 2
`[]` je prázdne pole, `[null]` je pole s jedným prvkom `null` a `null` znamená, že nebolo odovzdané žiadne pole. `count` číta len dĺžku poľa: počíta dva zoznamy, nie tri reťazce.
Súvisiace lekcie
- Java · Lekcia 3 · Pokročilá · Verzia: 2
- Java · Lekcia 14 · Pokročilá · Verzia: 2
Zdroje
- Java Language Specification, Java SE 21 — §8.4.1 Formal Parameters
- Java Language Specification, Java SE 21 — §8.4.2 Method Signature
- Java Language Specification, Java SE 21 — §15.12.2 Compile-Time Step 2: Determine Method Signature
- Java Language Specification, Java SE 21 — §15.12.4.2 Evaluate Arguments
- Java Language Specification, Java SE 21 — §4.7 Reifiable Types
- Java Language Specification, Java SE 21 — §4.12.2 Variables of Reference Type
- Java SE 21 API — SafeVarargs
- Java SE 21 API — Arrays.toString(Object[])
- JDK 21 Tool Specifications — The javac Command