CKTIS / Java
Arrays.stream(T[]): crear un flujo a partir de un array
Usa un array de elementos de tipo referencia como origen de un flujo secuencial, filtra sus elementos y guarda el resultado en un array del tipo adecuado.
Versión: Java SE 21
Sintaxis
public static <T> Stream<T> stream(T[] array)Arrays.stream(T[]) es un método estático de java.util.Arrays disponible desde Java 8. Usa un array de elementos de tipo referencia como origen de un java.util.stream.Stream<T> secuencial en orden de índices. Por ejemplo, un String[] produce un Stream<String>. El método no copia el array de origen; pasar una referencia de array null lanza NullPointerException.
Las operaciones intermedias como filter son perezosas: el procesamiento empieza al llamar a una operación terminal como toArray(). No modifiques el array de origen durante el procesamiento. No reutilices el mismo flujo después de una operación terminal. Para volver a procesar el array, crea un flujo nuevo.
La sobrecarga con rango, Arrays.stream(array, startInclusive, endExclusive), incluye el índice inicial y excluye el final. Requiere 0 <= startInclusive <= endExclusive <= array.length; unos límites inválidos provocan ArrayIndexOutOfBoundsException. Las sobrecargas para int[], long[] y double[] devuelven IntStream, LongStream y DoubleStream, respectivamente. No hay una sobrecarga directa para otros arrays unidimensionales de tipos primitivos, como boolean[].
En un Stream<T>, el tipo de retorno declarado del método sin argumentos toArray() es Object[], pero Java SE 21 no especifica la clase exacta del array devuelto en tiempo de ejecución. No hagas un cast de ese resultado a String[]; si necesitas un String[], usa toArray(String[]::new) en un flujo de cadenas.
Al usar reflexión, puedes pasar el Object[] resultante a Constructor.newInstance(Object...). Sus elementos se convierten, en orden, en los argumentos del constructor seleccionado. Su cantidad, orden y tipos deben ajustarse a los parámetros del constructor, teniendo en cuenta las conversiones permitidas. Un número incorrecto de argumentos o un tipo incompatible provoca IllegalArgumentException.
Ejemplos
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());
}
}Resultado
[Ada, Lin] Ada / Lin
`filter` descarta la cadena que solo contiene un espacio. `toArray()` coloca `Ada` y `Lin` en un `Object[]` en ese orden, y `newInstance` los pasa como dos argumentos al constructor de `Pair`.
Lecciones relacionadas
- Java · Lección 59 · Avanzado · Versión: 2
- Java · Lección 63 · Básico · Versión: 2