CKTIS / Java
Respetar el orden de encuentro con Stream.forEachOrdered
Usa `forEachOrdered` si una acción terminal debe respetar el orden de encuentro del flujo, incluso en una canalización paralela. `forEach` no ofrece esa garantía en modo paralelo.
Versión: Java SE 21
Sintaxis
java.util.Collection<E>: default Stream<E> parallelStream()
java.util.stream.Stream<T>: void forEachOrdered(Consumer<? super T> action)
Contrast on java.util.stream.Stream<T>: void forEach(Consumer<? super T> action)
collection.parallelStream().forEachOrdered(action);En Java SE 21, Collection.parallelStream() crea un flujo cuya fuente es la colección. La implementación predeterminada lo crea en modo paralelo, pero el contrato permite que una implementación devuelva un flujo secuencial. El modo paralelo no garantiza que se usen varios hilos ni que la ejecución sea más rápida.
Stream.forEachOrdered(action) es una operación terminal que devuelve void. Recibe un Consumer<? super T> y ejecuta la acción para cada elemento que llega al final de la canalización, siguiendo el orden de encuentro si está definido. Para una List, es el orden de sus elementos, y filter conserva el orden relativo de los que pasan el filtro. Un HashSet no define por sí solo ese orden. forEachOrdered no ordena los elementos ni establece un orden donde no lo hay.
Las acciones terminales se ejecutan de una en una: la acción de un elemento precede, en el sentido de happens-before, a las de los elementos siguientes. Las acciones pueden ejecutarse en hilos distintos, y las etapas previas pueden seguir ejecutándose en paralelo. Esta garantía se aplica a esas llamadas, no a los accesos independientes de otros hilos al estado compartido.
Stream.forEach(action) no garantiza el orden de encuentro en una canalización paralela, aunque en una ejecución concreta coincida por casualidad. Úsalo solo si el orden de las acciones no importa y asegúrate de que el acceso al estado compartido sea seguro. Con ambos métodos, la acción no debe interferir con la fuente del flujo. No reutilices un flujo después de una operación terminal; crea uno nuevo para volver a recorrer la fuente.
Ejemplos
import java.util.List;
import java.util.concurrent.atomic.AtomicInteger;
public class Main {
public static void main(String[] args) {
List<Integer> numbers = List.of(5, 2, 1, 4, 3);
numbers.parallelStream()
.filter(n -> n % 2 != 0)
.forEachOrdered(System.out::println);
AtomicInteger matches = new AtomicInteger();
numbers.parallelStream()
.filter(n -> n % 2 != 0)
.forEach(n -> matches.incrementAndGet());
System.out.println("Count: " + matches.get());
}
}Resultado
5 1 3 Count: 3
La primera canalización imprime los números impares en el orden de la lista: `5`, `1`, `3`, no en orden ascendente. La segunda usa `forEach` solo como contraste: incrementa un contador atómico, por lo que `Count: 3` no depende del orden de las acciones. Si solo necesitas contar, usa `count()` en lugar de un contador compartido.
Lecciones relacionadas
- Java · Lección 43 · Avanzado · Versión: 2
- Java · Lección 57 · Intermedio · Versión: 2