CKTIS / Java
Arrays.stream(T[]): creare uno stream da un array
Usa un array di elementi di tipo riferimento come origine di uno stream sequenziale, filtra gli elementi e salva il risultato in un array del tipo adatto.
Versione: Java SE 21
Sintassi
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) è un metodo statico di java.util.Arrays disponibile da Java 8. Usa un array di elementi di tipo riferimento come origine di uno stream sequenziale java.util.stream.Stream<T>, in ordine di indice. Per esempio, da uno String[] ottieni uno Stream<String>. Il metodo non copia l’array di origine; passare un riferimento all’array pari a null causa una NullPointerException.
Le operazioni intermedie come filter sono valutate in modo differito: l’elaborazione inizia quando viene chiamata un’operazione terminale come toArray(). Non modificare l’array di origine durante l’elaborazione. Non riutilizzare lo stesso stream dopo un’operazione terminale. Per elaborare di nuovo l’array, crea un nuovo stream.
L’overload con intervallo, Arrays.stream(array, startInclusive, endExclusive), include l’indice iniziale ed esclude quello finale. Richiede 0 <= startInclusive <= endExclusive <= array.length; limiti non validi causano una ArrayIndexOutOfBoundsException. Gli overload per int[], long[] e double[] restituiscono rispettivamente IntStream, LongStream e DoubleStream. Non c’è un overload diretto per altri array monodimensionali di tipi primitivi, come boolean[].
Su uno Stream<T>, il metodo senza argomenti toArray() ha come tipo di ritorno dichiarato Object[], ma Java SE 21 non specifica la classe esatta dell’array restituito a runtime. Non eseguire un cast del risultato a String[]; se ti serve uno String[], usa toArray(String[]::new) su uno stream di stringhe.
Quando usi la reflection, puoi passare l’Object[] risultante a Constructor.newInstance(Object...). I suoi elementi diventano, nell’ordine, gli argomenti del costruttore selezionato. Numero, ordine e tipi devono corrispondere ai parametri del costruttore, tenendo conto delle conversioni consentite. Un numero errato di argomenti o un tipo incompatibile causa una IllegalArgumentException.
Esempi
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());
}
}Risultato
[Ada, Lin] Ada / Lin
`filter` scarta la stringa che contiene solo uno spazio. `toArray()` inserisce `Ada` e `Lin` in un `Object[]` in quest’ordine, e `newInstance` li passa come due argomenti al costruttore di `Pair`.
Lezioni correlate
- Java · Lezione 59 · Avanzato · Versione: 2
- Java · Lezione 63 · Base · Versione: 2