//NextPatch
Perfil

Java 11 → 17: seis versiones de lenguaje · La API que heredas

Stream.toList() vs Collectors.toList() en Java: diferencias

Cargando la lección…

Guarda tu racha: crea tu cuenta

Este reto se sumará a tu cuenta nueva: su XP y tu primer día de racha. Luego, uno nuevo cada día para preparar tu próxima entrevista.

Durante años, casi todos los pipelines de streams terminaban igual: .collect(Collectors.toList()). Java 16 añadió un atajo, Stream.toList(), y con él una duda muy habitual en entrevistas: ¿son lo mismo?

java
List<String> names = people.stream()
        .map(Person::name)
        .toList();

Las tres formas de terminar en una lista

  • collect(Collectors.toList()): la clásica. La especificación no garantiza ni el tipo ni si la lista se puede modificar, aunque en la práctica se pueda.
  • collect(Collectors.toUnmodifiableList()): lista inmodificable, y lanza NullPointerException si le llega un elemento nulo.
  • toList(): lista inmodificable que sí admite nulos. Su especificación dice que se produce como si fuera Collections.unmodifiableList(new ArrayList<>(...)).

Lo que hay que recordar

La lista de toList() no se puede modificar: add, remove o set compilan, porque el tipo sigue siendo List, pero lanzan UnsupportedOperationException en ejecución. Si migras un collect(Collectors.toList()) a toList() y algún código posterior añadía elementos a esa lista, fallará.

La diferencia con toUnmodifiableList() es el tratamiento de null: las dos son inmodificables, pero solo toList() acepta elementos nulos.

Cuál usar

En código nuevo, toList() por defecto: es más corto, no necesita importar Collectors y deja claro que el resultado no se toca. Si necesitas una lista que puedas modificar, sigue con Collectors.toList() o, mejor aún, Collectors.toCollection(ArrayList::new), que garantiza el tipo.

Y mapMulti

En la misma versión llegó Stream.mapMulti, un mapeo de uno a muchos en el que empujas tú los resultados a un consumidor en vez de devolver un stream por elemento, como hace flatMap. Compensa cuando la mayoría de elementos producen cero o un resultado.