CKTIS / Java
Arrays.stream(T[]): een stream maken vanuit een array
Gebruik een array met elementen van een referentietype als bron voor een sequentiële stream, filter de elementen en sla het resultaat op in een array van het juiste type.
Versie: Java SE 21
Syntax
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) is een statische methode in java.util.Arrays, beschikbaar sinds Java 8. De methode gebruikt een array met elementen van een referentietype als bron voor een sequentiële java.util.stream.Stream<T> in indexvolgorde. Zo levert een String[] een Stream<String> op. De methode kopieert de bronarray niet; een arrayreferentie met waarde null leidt tot een NullPointerException.
Tussenbewerkingen zoals filter worden uitgesteld: de verwerking begint pas wanneer je een eindbewerking zoals toArray() aanroept. Wijzig de bronarray niet tijdens de verwerking. Gebruik dezelfde stream niet opnieuw na een eindbewerking. Maak een nieuwe stream als je de array opnieuw wilt verwerken.
De overload met een bereik, Arrays.stream(array, startInclusive, endExclusive), neemt de beginindex wel mee en de eindindex niet. Er moet gelden: 0 <= startInclusive <= endExclusive <= array.length. Ongeldige grenzen leiden tot een ArrayIndexOutOfBoundsException. De overloads voor int[], long[] en double[] geven respectievelijk IntStream, LongStream en DoubleStream terug. Voor andere eendimensionale arrays van primitieve typen, zoals boolean[], bestaat geen directe overload.
Bij een Stream<T> is Object[] het gedeclareerde retourtype van de methode toArray() zonder argumenten. Java SE 21 legt echter niet vast welke klasse de teruggegeven array tijdens de uitvoering precies heeft. Cast dat resultaat niet naar String[]; als je een String[] nodig hebt, gebruik dan toArray(String[]::new) op een stream van strings.
Bij reflectie kun je het resulterende Object[] doorgeven aan Constructor.newInstance(Object...). De elementen worden achtereenvolgens argumenten voor de geselecteerde constructor. Het aantal, de volgorde en de typen moeten overeenkomen met de parameters van die constructor, rekening houdend met toegestane conversies. Een onjuist aantal argumenten of een incompatibel type leidt tot een IllegalArgumentException.
Voorbeelden
import java.util.Arrays;
public class Main {
public record Pair(String first, String second) {}
public static void main(String[] args) throws ReflectiveOperationException {
String[] input = {"Ada", " ", "Lin"};
Object[] arguments = Arrays.stream(input)
.filter(name -> !name.isBlank())
.toArray();
Pair pair = Pair.class.getConstructor(String.class, String.class)
.newInstance(arguments);
System.out.println(Arrays.toString(arguments));
System.out.println(pair.first() + " / " + pair.second());
}
}Resultaat
[Ada, Lin] Ada / Lin
`filter` verwijdert de string die alleen uit één spatie bestaat. `toArray()` zet `Ada` en `Lin` in die volgorde in een `Object[]`, en `newInstance` geeft ze als twee argumenten door aan de constructor van `Pair`.
Gerelateerde lessen
- Java · Les 59 · Gevorderd · Versie: 2
- Java · Les 63 · Basis · Versie: 2