Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes