WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Arrays.stream(T[]): einen Stream aus einem Array erstellen

Verwende ein Array mit Elementen eines Referenztyps als Quelle für einen sequenziellen Stream, filtere die Elemente und speichere das Ergebnis in einem Array mit passendem Typ.

Version: Java SE 21

Syntax

public static <T> Stream<T> stream(T[] array)

Arrays.stream(T[]) ist eine statische Methode in java.util.Arrays, die seit Java 8 verfügbar ist. Sie verwendet ein Array mit Elementen eines Referenztyps als Quelle für einen sequenziellen java.util.stream.Stream<T> in Indexreihenfolge. Ein String[] ergibt beispielsweise einen Stream<String>. Die Methode kopiert das Quellarray nicht. Eine null-Arrayreferenz führt zu einer NullPointerException.

Zwischenoperationen wie filter werden verzögert ausgewertet: Die Verarbeitung beginnt erst mit dem Aufruf einer Endoperation wie toArray(). Verändere das Quellarray während der Verarbeitung nicht. Verwende denselben Stream nach einer Endoperation nicht erneut. Erstelle einen neuen Stream, wenn du das Array noch einmal verarbeiten willst.

Die Überladung mit Indexbereich, Arrays.stream(array, startInclusive, endExclusive), schließt den Startindex ein und den Endindex aus. Es muss 0 <= startInclusive <= endExclusive <= array.length gelten; ungültige Grenzen führen zu einer ArrayIndexOutOfBoundsException. Für int[], long[] und double[] liefern die Überladungen jeweils IntStream, LongStream und DoubleStream. Für andere eindimensionale Arrays primitiver Typen wie boolean[] gibt es keine direkte Überladung.

Bei einem Stream<T> ist Object[] der deklarierte Rückgabetyp der parameterlosen Methode toArray(). Java SE 21 legt jedoch die genaue Laufzeitklasse des zurückgegebenen Arrays nicht fest. Wandle das Ergebnis nicht per Cast in String[] um. Wenn du ein String[] brauchst, verwende bei einem Stream von Zeichenketten toArray(String[]::new).

Bei der Verwendung von Reflection kannst du das resultierende Object[] an Constructor.newInstance(Object...) übergeben. Seine Elemente werden der Reihe nach als Argumente an den ausgewählten Konstruktor übergeben. Anzahl, Reihenfolge und Typen müssen unter Berücksichtigung zulässiger Konvertierungen zu dessen Parametern passen. Eine falsche Argumentanzahl oder ein unpassender Typ führt zu einer IllegalArgumentException.

Beispiele

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

Ergebnis

[Ada, Lin]
Ada / Lin

`filter` verwirft die Zeichenkette, die nur ein Leerzeichen enthält. `toArray()` legt `Ada` und `Lin` in dieser Reihenfolge in einem `Object[]` ab. `newInstance` übergibt sie als zwei Argumente an den Konstruktor von `Pair`.

Zugehörige Lektionen

  • Java · Lektion 59 · Fortgeschritten · Version: 2
  • Java · Lektion 63 · Grundlagen · Version: 2

Quellen